API 文档接口参考
获取结果
每隔几秒轮询,直到 status 为 succeeded 或 failed。输出链接由供应商托管,可能过期,请及时下载保存;也可以传 callback_url 接收推送。
GET
/api/v1/generations/{id}需要 Bearer API Key请求
cURL
curl 'https://01router.com/api/v1/generations/gen_example' \
-H "Authorization: Bearer $API_KEY"输入参数
查询 / 路径参数idstring · path必填创建任务返回的生成 ID。
响应示例
200 · application/json
{
"id": "gen_example",
"object": "generation",
"model": "seedance-2.5",
"type": "video",
"provider": "01router",
"status": "succeeded",
"input": {
"prompt": "A red fox running through fresh snow, cinematic"
},
"outputs": [
"https://example.com/result.mp4"
],
"error": null,
"credits": 100,
"price_usd": 1,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": "2026-10-25T08:01:00.000Z"
}响应仅用于说明结构;ID、用量、价格和结果以实际请求为准。
输出字段
idstring创建任务返回的生成 ID。
object"generation"generation
modelstring模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。
typevideo | image | audio | chatproviderstring可选供应商 slug。不传时自动路由;项目配置可能固定供应商。
statusstringqueued(排队)/ processing(处理中)/ succeeded(成功)/ failed(失败)。成功或失败后停止轮询。
inputobject模型专属的输入对象。必填字段、默认值和限制见对应模型文档。
outputsstring[]结果文件 URL 列表;结果未就绪时为空。链接可能过期,请及时下载。
errorstring | null失败时的错误信息,否则为 null。
creditsnumber该任务扣除的积分,退款后为 0。
price_usdnumber该任务的美元价格,退款后为 0。
created_atstringISO 8601 格式的创建时间。
completed_atstring | nullISO 8601 格式的完成时间,进行中为 null。
使用说明
- 轮询间隔至少 3 秒。同步生图接口返回 504 时,任务可能仍在进行,应使用 error.id 查询,避免重复创建。
给 AI 使用
把文档索引或完整接口文档交给 AI 编程助手,包含实时模型参数。