查询视频生成

从源码生成 GET /video-generations/{job_id} 的鉴权、字段、响应、错误与安全调用参考。

公开测试API v1 · 1.3.0最后核实 2026-08-30

本页目录

操作

GET /video-generations/{job_id}

operationId: get_video_generation_v1_video_generations__job_id__get

读取所属任务。遵循 Retry-After 并设置轮询截止时间。queued、running、cancelling 非终态；succeeded、failed、cancelled 为终态。后续阶段失败仍可能有可用产物，进度不代表精确时间。

鉴权与副作用

使用可信环境中的 Bearer API Key。所需权限：animations:read

此操作不启动付费生成，其他状态变化见上文说明。

参数

参数	位置	类型	必填	约束 / 默认值	含义
`job_id`	`path`	`string`	是	`format`: `uuid`	所属公共资源 UUID；任务、资产、文件 ID 不能互换。

响应

HTTP	正文	含义
`200`	TaskResponse	成功的公开响应，示例数值仅用于说明。
`400`	APIErrorEnvelope	输入错误，修正请求后再尝试。
`401`	APIErrorEnvelope	API Key 缺失、到期或被撤销。
`403`	APIErrorEnvelope	账户资格、账户状态或 Key 权限不允许此操作。
`404`	APIErrorEnvelope	资源不可用、不属于当前用户，或签名无效/过期。
`429`	APIErrorEnvelope	触发账户级速率或队列限制，遵循 Retry-After 等待。
`500`	APIErrorEnvelope	内部错误，保留任务 ID 和幂等键，仅标记可重试时重试。
`503`	APIErrorEnvelope	服务或供应商不可用，仅 error.retryable 为 true 时重试。

响应头

HTTP	响应头	类型	含义
`200`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。
`429`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。
`503`	`Retry-After`	`integer`	建议等待秒数，遵循服务值并设置总体截止时间。

响应示例

json

{
  "created_at": "2026-08-30T00:00:00Z",
  "credits": {
    "charged": 0,
    "held": 1,
    "quoted": 1
  },
  "error": null,
  "finished_at": null,
  "id": "00000000-0000-4000-8000-000000000002",
  "metadata": {},
  "normalized_input": {},
  "object": "video_generation",
  "outputs": [
    {
      "byte_size": 1024,
      "created_at": "2026-08-30T00:00:00Z",
      "download_expires_at": "2026-08-30T01:00:00Z",
      "download_url": "https://downloads.example.invalid/illustrative-asset",
      "format": "clip_video",
      "id": "00000000-0000-4000-8000-000000000003",
      "mime_type": "video/mp4",
      "object": "asset"
    }
  ],
  "progress": 1,
  "stage": "completed",
  "started_at": null,
  "status": "succeeded"
}

这篇文档有帮助吗？

允许文档使用分析

不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。隐私政策

需要帮助？联系支持

搜索文档

查询视频生成

操作

鉴权与副作用

参数

响应

响应头

响应示例

相关教程

这篇文档有帮助吗？