Replicate 接入教程

⚠️ 测试中

Replicate 是一个聚合了众多开源 AI 模型的平台，开发者可以通过简单的 API 调用访问包括 Stable Diffusion、Flux、Claude Sora 等数千种 AI 模型。Replicate 将复杂的模型部署和推理过程封装成简单的 API 接口，大大降低了 AI 能力的集成门槛。

QuickRouter API 提供对 Replicate 平台的统一中转访问，将官方 API 端点替换为 QuickRouter 地址，国内开发者即可享受稳定快速的 AI 模型调用体验，同时避免跨境网络问题。

核心概念

模型与 Version

Replicate 上的每个模型都有唯一标识，格式为 username/model-name，如 stability-ai/stable-diffusion。每个模型可能有多个版本（version），版本 ID 是一个长字符串，用于指定具体使用哪个版本的模型。

预测任务（Prediction）

所有模型调用都通过创建 Prediction（预测任务）来实现。提交任务后会立即返回任务 ID，开发者需要轮询查询任务状态直到完成。

输入与输出

模型的输入（input）是一个 JSON 对象，字段因模型而异；输出（output）可能是图像 URL、视频 URL 或其他类型的数据。

接入流程

第一步：创建任务

通过 POST 请求创建预测任务：

curl --request POST \
  --url https://api.quickrouter.ai/replicate/v1/predictions \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "version": "2a6b576af31790b470f0a8442e1e9791213fa13799cbb65a9fc1436e96389574",
    "input": {
      "prompt": "A beautiful sunset over the ocean"
    }
  }'

响应：

{
  "id": "qpt5jq1fssrmc0cmd5hvy31mdg",
  "status": "starting"
}

第二步：查询任务状态

curl --request GET \
  --url https://api.quickrouter.ai/replicate/v1/predictions/qpt5jq1fssrmc0cmd5hvy31mdg \
  --header 'Authorization: Bearer YOUR_API_KEY'

第三步：获取结果

当 status 变为 succeeded 时，从 output 字段获取结果。

返回体关键字段

id：任务 ID，用于查询状态
status：任务状态（starting/processing/succeeded/failed）
output：任务结果，类型因模型而异
error：错误信息（失败时）