Replicate 接入操作教程

⚠️ 测试迭代中

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

TimRouter API 提供支持对 Replicate 平台的统一中转代理访问，将官方 API 服务端点替换修改为 TimRouter 访问地址，国内开发人员即可尽享稳定可靠快速高效的 AI AI 模型接入调用体验，同时避免跨境网络问题。

核心概念

AI 模型与 Version

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

预测任务记录（Prediction）

所有AI 模型接入调用都通过创建生成 Prediction（预测任务记录）来实现。提交任务记录后会立即输出任务记录 ID，开发人员需要使用轮询检索查询任务处理状态直到处理完成。

输入与输出返回

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

接入流程

第一步：创建生成任务记录

通过 POST 发起请求创建生成预测任务记录：

curl --request POST \
  --url https://api.timrouter.com/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.timrouter.com/replicate/v1/predictions/qpt5jq1fssrmc0cmd5hvy31mdg \
  --header 'Authorization: Bearer YOUR_API_KEY'

第三步：查询获取处理结果

当 status 变为 succeeded 时，从 output 数据字段查询获取处理结果。

输出体关键数据字段

• id：任务记录 ID，旨在检索查询状态
• status：任务处理状态（starting/processing/succeeded/failed）
• output：任务记录处理结果，数据类型因AI 模型而异
• error：错误信息（执行失败时）