查询视频

提交生成请求后，保存返回的任务 ID，并使用同一站点的 API Key 查询。停止轮询不会取消上游生成任务。

GET/v1/video/generations/{task_id}

使用平台创建接口返回的任务 ID 查询当前用户的任务。停止客户端轮询不会取消生成任务。

Authorization

bearerAuth

AuthorizationBearer <token>

使用平台 API Key：Authorization: Bearer your-api-key。

In: header

Path Parameters

task_id*string

创建接口返回的系统任务 ID。新任务 ID 为字符串，不能转换为数字以免丢失精度。

Length1 <= length

Response Body

`application/json`

curl -X GET "https://api.agtcloud.cn/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "processing",
    "task_id": "123456789012345678",
    "url": ""
  }
}

如何读取查询结果

平台查询返回 code/message/data 包装，data 是单个任务对象。code: "success" 表示本次查询成功，仍需查看 data.status 判断视频是否生成完成。

情况	响应含义与处理
HTTP 200，`data.status: "processing"`	任务仍在处理，`data.url` 可为空字符串，可稍后继续查询
HTTP 200，`data.status: "succeeded"`	视频已生成，从 `data.url` 读取地址并及时保存
HTTP 400，`code: "task_not_exist"`	未找到任务，检查任务 ID、API Key 和所属站点
HTTP 401，`Invalid token`	检查 Bearer 鉴权格式及 API Key 是否属于请求站点；缺少和无效 Key 可能返回相同错误

data.error 和 data.metadata 可能为 null。平台包装不等同于原生查询的 data[]；原生字段与刊例价结构参见原生查询接口。

HTTP 400/401 是本次查询请求的错误，不等同于任务生成失败。错误响应可能没有正常的任务对象；先处理错误，不要继续读取视频地址或持续轮询。

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

如何读取查询结果

`application/json`

`application/json`

`application/json`