芯剪开放平台查询任务
轮询任务状态、拿产物地址、看实际消耗。
GET /v1/tasks/{task_id}
curl https://api.gomiservice.com/v1/tasks/GMI-XXXXXXXXXXXXX \
-H "Authorization: Bearer sk-gomi-你的Key"{
"task": {
"task_id": "GMI-XXXXXXXXXXXXX",
"status": "succeeded",
"model": "image2",
"output_type": "image",
"created_at": 1789013140,
"finished_at": 1789013202,
"urls": ["https://…签名地址…"],
"error_code": "",
"error_message": "",
"cost_points": 20
}
}只能查本团队的任务，查别人的任务和查不存在的编号都是 TASK_NOT_FOUND。
状态流转
pending → submitted → running → succeeded / failed- 判断是否结束只看两个终态：
succeeded/failed。中间态的具体名称可能随实现调整，不要对它们写死逻辑 - 建议轮询间隔 5–10 秒；生图通常几十秒，生视频几分钟
failed时看error_code分支（见错误码），已扣点数自动退还
产物地址
urls是带签名的临时下载地址（防止产物被永久外链），拿到时保证至少还有 3 天有效期- 需要长期使用请及时转存到你自己的存储；地址过期后重新调一次查询接口即可拿到新地址，产物本身不会删
- 3 天内重复查询返回的地址不变，可放心缓存
消耗
- 终态前
cost_points是提交时的预估值；终态后是实际结算值 - 失败任务实际消耗为 0（自动退款）