用途:通过 Replicate 的 HTTP API 在云端运行开源机器学习模型,适用于图像生成(SDXL、FLUX Schnell 等扩散模型)、文本生成(Llama 等开源 LLM),以及执行 replicate.com 上托管的任意模型,并轮询异步预测任务状态。
主要能力:按版本 ID 或模型最新版本提交预测;查询预测状态与输出;列出近期预测;搜索模型;获取模型详情;通过 Deployment 运行。
使用方式:所有预测均为异步,先提交任务再轮询至 succeeded 或 failed。需先连接 Replicate 连接器(app.vm0.ai/connectors)。提交示例:curl -s -X POST "https://api.replicate.com/v1/predictions" --header "Authorization: Bearer $REPLICATE_TOKEN" --header "Content-Type: application/json" -d @/tmp/replicate_prediction.json | jq '{id, status, urls}'。运行最新版本用 /v1/models/<owner>/<model-name>/predictions;轮询用 GET /v1/predictions/<prediction-id>。状态含义:starting(冷启动)、processing(运行中)、succeeded(输出就绪)、failed(查看 error)、canceled。
适用场景:图像生成、文本生成、运行任意托管模型。
限制:预测异步,必须轮询,不能假设即时完成;建议每 2–5 秒轮询一次,冷启动模型首次预测可能需 30–60 秒;图像输出为 URL 数组,文本输出为 token 字符串数组需拼接。故障排查可运行 zero doctor check-connector --env-name REPLICATE_TOKEN 或 zero doctor check-connector --url https://api.replicate.com/v1/models --method GET。