查询视频生成任务

H3 视频任务 API · /api/v3

请求地址

GEThttps://fablun.com/api/v3/contents/generations/tasks/{id}

使用创建返回的 cgt-… 原始 ID。查询限额为同一账户共享 20 QPS。

请求与响应

cURL

curl 'https://fablun.com/api/v3/contents/generations/tasks/cgt-0123456789abcdef0123456789abcdef' \
  -H "Authorization: Bearer $ARK_API_KEY"

JSON · 成功响应示例

{
  "id": "cgt-0123456789abcdef0123456789abcdef",
  "model": "h3-pro",
  "status": "succeeded",
  "created_at": 1793600000,
  "updated_at": 1793600030,
  "content": {
    "video_url": "https://YOUR_RESULT_HOST/video.mp4?SIGNED_QUERY"
  },
  "seed": 42,
  "resolution": "480p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24,
  "generate_audio": true,
  "service_tier": "default",
  "error": null
}

字段	类型	说明
`status`	string	任务状态，见下表。
`content.video_url`	string \| null	播放 / 保存链接，完成后有效 1 小时，查询不续期。
`seed`	integer	实际种子，随机任务也会返回确定值。
`created_at / updated_at`	integer	Unix 时间戳，单位秒。
`error`	object \| null	失败时读取 code / message，成功为 null。

任务状态

status	含义	处理方式
`queued`	排队中	继续查询同一个任务。
`running`	处理中	准备输入、模型生成或视频交付；继续查询。
`succeeded`	成功	读取 content.video_url；链接过期后可能为 null。
`failed`	失败	读取 error.code 和 error.message。
`expired`	任务超时	包含排队的任务有效期已结束。
`cancelled`	已取消	停止查询。

建议每 2 秒查询。客户端等待超时不会取消任务，保存 ID 后继续查询。普通任务记录自创建起保留 7 天，已取消任务保留 24 小时；视频 URL 则仅有效 1 小时。