本文将介绍慧星云查询视频生成任务API的使用。仅支持查询最近 7 天的历史数据。
POST
/api.huixingyun.com/v1/videos/retrievals鉴权
使用 Bearer token 方式进行 API 鉴权，格式为 Bearer 加上 API Key。Curl 请求中 HTTP Auth 头示例：
--header 'Authorization: Bearer sk-xxxxxxxxxxxxxx' \请求
Body
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 需要查询的视频生成任务 ID 。 |
响应
Body
| 名称 | 类型 | 说明 |
|---|---|---|
| id | string | 视频生成任务 ID 。 |
| model | string | 任务使用的模型名称和版本，模型名称-版本 |
| status | string | 任务状态，以及相关的信息：queued：排队中。running：任务运行中。cancelled：取消任务，取消状态24h自动删除（只支持排队中状态的任务被取消）。succeeded： 任务成功。failed：任务失败。expirednew：任务超时。 |
| video_url | string | 生成视频的 URL，格式为 mp4。为保障信息安全，生成的视频会在24小时后被清理，请及时转存。 |
| completion_tokens | integer | 模型输出视频花费的 token 数量。 |
| total_tokens | integer | 本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens=completion_tokens。 |
| created_at | integer | 任务创建时间的 Unix 时间戳（秒）。 |
调用示例
curl -X POST https://api.huixingyun.com/v1/videos/retrievals \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-cuN8CNKiY76GtOGGCa2f**********528bB4111e91Ec226d" \
-d '{
"model": "doubao-seedance-1-0-pro-250528",
"video_id": "cgt-20251216180900-9v2lt"
}'
{
"id": "cgt-20251216180900-9v2lt",
"model": "doubao-seedance-1-0-pro-250528",
"status": "succeeded",
"video_url": "https://……",
"completion_tokens": 246840,
"total_tokens": 246840,
"created_at": 1765879740
}