青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/replicate/v1/predictions

创建任务-通过模型version（predictions）

version models 支持以下 "ac732df83cea7fff18b8472768c88ad041fa750ff7682a21affe81863cbe77e4": "stability-ai/stable-diffusion", "7762fd07cf82c948538e41f63f77d685e02b063e37e496e96eefd46c929f9bdc": "stability-ai/sdxl", "95b7223104132402a9ae91cc677285bc5eb997834bd2349fa486f53910fd68b3": "stability-ai/stable-diffusion-inpainting", "15a3689ee13b0d2616e98820eca31d4c3abcd36672df6afce5cb6feb1d66087d": "stability-ai/stable-diffusion-img2img", "2a6b576af31790b470f0a8442e1e9791213fa13799cbb65a9fc1436e96389574": "lucataco/flux-schnell-lora", "091495765fa5ef2725a175a57b276ec30dc9d39c22d30410f2ede68a3eab66b3": "lucataco/flux-dev-lora", "ca1f5e306e5721e19c473e0d094e6603f0456fe759c10715fcd6c1b79242d4a5": "andreasjansson/stable-diffusion-animation", "beecf59c4aee8d81bf04f0381033dfa10dc16e845b4ae00d281e2fa377e48a9f": "lucataco/animate-diff", "153b0087c2576ad30d8cbddb35275b387d1a6bf986bda5499948f843f6460faf": "sujaykhandekar/object-removal", "fb8af171cfa1616ddcf1242c093f9c46bcada5ad4cf6f2fbe8b81b330ec5c003": "cjwbw/rembg" models 具体参数请前往 replicate.com 查看具体模型请求参数

API Key application/json
Replicate Predictions 协议

调用与返回说明

本站通过 Replicate 兼容路径创建 prediction。每个模型的 `input` 是独立契约；页面只描述该模型快照，不把一个模型的字段推广到其他模型。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY` 和 `Content-Type: application/json`。客户端只提交青云TOP API Key，不提交 Replicate 上游令牌。
  • 具体模型创建页的 Body 是 `{ "input": { ... } }`；通过版本创建时另需 `version`。不要把不同模型的 input 对象混用。
  • 模型页面来自 2026-08-19 的 Apifox 快照，调用前先请求 `GET /v1/models` 或使用控制台当前模型列表确认权限、型号和版本；快照不是永久 allowlist。
  • 创建响应中的 `id` 是后续查询使用的 prediction ID；同时保存 model、version 和 created_at 便于排错。

返回时注意

  • HTTP 2xx 只表示请求被接受，业务结果以 prediction 的 `status` 为准。处理 failed、canceled、超时和网络断开时不要把任务标记为成功。
  • 成功结果位于 `output`，可能是单个 URL 或 URL 数组；响应中的临时地址约 1 小时有效，下载后保存到自有存储。
  • 如配置 webhook，必须校验签名、限制重放并让回调处理幂等；没有配置回调时使用查询接口和退避轮询。
Request

请求

/replicate/v1/predictions

Body

可选
Bodyapplication/json
Bodyobject
versionstring
inputobject
widthinteger

生成图像的宽度（以像素为单位）。需要为 64 的倍数。默认值：768。

heightinteger

生成图像的高度（以像素为单位）。需要为 64 的倍数。默认值：768。

promptstring

输入提示。

schedulerstring

选择一个调度程序。默认值：“DPMSolverMultistep”。

num_outputsinteger

要生成的图像数量。默认值：1。最小值：1，最大值：4。

guidance_scalenumber必填

无分类器引导尺度。默认值：7.5。最小值：1，最大值：20。

num_inference_stepsinteger必填

去噪步骤数。默认值：50。最小值：1，最大值：500。

路径、查询与 Header 参数

参数位置类型必填说明示例
AuthorizationHeaderstring是必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。Bearer YOUR_API_KEY
Response

返回响应 200

HTTP 响应
响应 200json
响应 200object
idstring必填

prediction 公开 ID，查询和回调关联使用。

modelstring必填
versionstring必填
inputobject必填

实际提交的模型输入对象。

aspect_ratiostring必填
input_imagestring必填
output_formatstring必填
promptstring必填
prompt_upsamplingboolean必填
safety_toleranceinteger必填
logsstring必填
outputstring | array<string> | null必填

成功后的临时结果 URL；未完成或失败时可能为空。

data_removedboolean必填
errorstring | null必填

失败原因。不要只依赖 HTTP 状态码。

statusstring必填

starting、processing、succeeded、failed 或 canceled 等任务状态。

created_atstring必填
urlsobject必填
cancelstring必填
getstring必填
streamstring必填
webstring必填
metricsobject
predict_timenumber | null

可用时的预测耗时，用于观测，不作为成功判定。

Replicate Predictions 协议

调用与返回说明

本站通过 Replicate 兼容路径创建 prediction。每个模型的 `input` 是独立契约；页面只描述该模型快照，不把一个模型的字段推广到其他模型。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY` 和 `Content-Type: application/json`。客户端只提交青云TOP API Key，不提交 Replicate 上游令牌。
  • 具体模型创建页的 Body 是 `{ "input": { ... } }`；通过版本创建时另需 `version`。不要把不同模型的 input 对象混用。
  • 模型页面来自 2026-08-19 的 Apifox 快照，调用前先请求 `GET /v1/models` 或使用控制台当前模型列表确认权限、型号和版本；快照不是永久 allowlist。
  • 创建响应中的 `id` 是后续查询使用的 prediction ID；同时保存 model、version 和 created_at 便于排错。

返回时注意

  • HTTP 2xx 只表示请求被接受，业务结果以 prediction 的 `status` 为准。处理 failed、canceled、超时和网络断开时不要把任务标记为成功。
  • 成功结果位于 `output`，可能是单个 URL 或 URL 数组；响应中的临时地址约 1 小时有效，下载后保存到自有存储。
  • 如配置 webhook，必须校验签名、限制重放并让回调处理幂等；没有配置回调时使用查询接口和退避轮询。