{
"id": "task_example",
"object": "video",
"model": "YOUR_MODEL_ID",
"status": "queued",
"progress": 0,
"created_at": 1700000000
}API 参考
查询视频任务
请求格式、响应与能力边界。
{
"id": "task_example",
"object": "video",
"model": "YOUR_MODEL_ID",
"status": "queued",
"progress": 0,
"created_at": 1700000000
}GET /v1/videos/{task_id}
task_id 是创建响应中的网关 id。使用同一用户/项目范围的凭据;任务不存在或不属于该范围时可能返回 400,而不总是 404。
queued / in_progress 继续等待;completed 后下载;failed 或 unknown 停止自动流程并检查日志。快照可能落后于上游,progress 不能替代 status。额外字段可能由插件保留,不能把某个供应商的 url 当作统一必有字段。
完整接入指南与可执行示例
Read in English授权
模型调用 API Key,不是控制台登录凭据 / Model API key, not console login credentials
路径参数
同一用户/项目范围内的网关公开 ID / Public gateway ID in the same user/project scope
响应
任务快照,可能尚未更新到最新上游状态 / Task snapshot; may lag upstream state
网关公开任务 ID,后续查询/下载使用此值 / Public gateway task ID; use for retrieval/download
示例:
"task_example"
示例:
"video"
当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint
示例:
"YOUR_MODEL_ID"
以状态判断完成;unknown 必须单独处理 / Determine completion from status; handle unknown separately
可用选项:
queued, in_progress, completed, failed, unknown 进度提示,不等同于完成保证 / Progress hint, not proof of completion
Unix 秒 / Unix seconds
完成时间,可省略 / Completion timestamp; may be omitted
渠道可能提供的过期时间 / Optional expiry from channel
Show child attributes
Show child attributes