POST
/replicate/v1/predictions创建任务 lucataco/remove-bg
官方文档:https://replicate.com/lucataco/remove-bg
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/predictionsBody
可选Bodyobjectversionstringinputobject
inputobjectimagestring必填从此图像中删除背景。
路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
Response返回响应
HTTP 响应返回响应 200
响应 200objectidstring必填prediction 公开 ID，查询和回调关联使用。
modelstring必填versionstring必填inputobject必填实际提交的模型输入对象。
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必填
urlsobject必填cancelstring必填getstring必填streamstring必填webstring必填metricsobject
metricsobjectpredict_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，必须校验签名、限制重放并让回调处理幂等；没有配置回调时使用查询接口和退避轮询。