查询视频任务

请求格式、响应与能力边界。

200

{
  "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

授权

Authorization · string · header · 必填

模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials

路径参数

task_id · string · 必填

同一用户/项目范围内的网关公开 ID / Public gateway ID in the same user/project scope

响应

200

application/json

任务快照，可能尚未更新到最新上游状态 / Task snapshot; may lag upstream state

id · string · 必填

网关公开任务 ID，后续查询/下载使用此值 / Public gateway task ID; use for retrieval/download

示例:

"task_example"

object · string · 必填

示例:

"video"

model · string · 必填

当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint

示例:

"YOUR_MODEL_ID"

status · enum<string> · 必填

以状态判断完成；unknown 必须单独处理 / Determine completion from status; handle unknown separately

可用选项: queued, in_progress, completed, failed, unknown

progress · integer · 必填

进度提示，不等同于完成保证 / Progress hint, not proof of completion

created_at · integer · 必填

Unix 秒 / Unix seconds

completed_at · integer

完成时间，可省略 / Completion timestamp; may be omitted

expires_at · integer

渠道可能提供的过期时间 / Optional expiry from channel

seconds · string

size · string

error · object

Show child attributes

metadata · object