通用接口
视频任务查询
GEThttps://api.storymo.art/v1/videos/{task_id}
GET /v1/videos/{task_id}
认证
请求头 Authorization: Bearer YOUR_API_KEY。API Key 可在网站“开发者 API”页面创建。
路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 提交接口返回的 task_id;拼接 URL 时编码 |
无请求体。只能查询当前账户的视频任务;任务不存在、类型错误或不属于当前账户均返回 404。
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| task_id | string | 任务 ID |
| taskId | string | 兼容别名 |
| type | string | video |
| status | string | queued、running、succeeded、failed、canceled |
| progress | number | 参考进度;以 status 判断是否完成 |
| outputs | array | 成功时包含 {type,url};其他状态或链接不可用时为空 |
| videoUrl | string/null | 兼容的结果链接,推荐统一读取 outputs |
| error | object/null | 失败时包含 code、message、error_id |
| credits | number | 任务记录的积分,不代表退款后的净额 |
| created_at | string | 创建时间,通常为 ISO 8601 |
| completed_at | string/null | 终结时间,未完成时可能为 null |
轮询与下载
- queued:排队中,继续查询。
- running:生成中,继续查询。
- succeeded:已完成,下载 outputs[0].url。
- failed:失败,停止查询并显示 error。
- canceled:已取消,停止查询。
建议每 3–5 秒查询一次;网络错误退避到 10–30 秒。等待超时可保留 task_id 稍后续查,不需重新创建任务。成功但 outputs 为空时稍后重查;持续为空可联系平台。下载链接可能过期,重新查询获取链接。下载请求不带 API Key。