查询任务#
GET https://platform.shuyanai.com/vidu/ent/v2/tasks/{task_id}/creations
请求参数#
请求 头#
| 头部 | 必填 | 说明 |
|---|
Authorization | 是 | Bearer sk-xxx |
路径参数#
| 参数 | 类型 | 必填 | 说明 |
|---|
task_id | String | 是 | 创建任务时返回的 task_id |
请求示例#
建议每 10–15 秒查询一次，直到 state 为 success 或 failed。响应参数#
| 字段 | 子字段 | 类型 | 说明 |
|---|
id | | String | 任务 ID |
type | | String | 任务类型，如 text2video、img2video |
model | | String | 使用的模型 |
state | | String | 处理状态：created、queueing、processing、success、failed |
progress | | Int | 进度，0–100 |
err_code | | String | 错误码，任务失败时返回 |
err_msg | | String | 错误信息，任务失败时返回 |
duration | | Int | 视频时长（秒） |
resolution | | String | 分辨率 |
aspect_ratio | | String | 宽高比 |
audio | | Bool | 是否开启音视频直出 |
bgm | | Bool | 是否添加背景音乐 |
off_peak | | Bool | 是否使用错峰模式 |
template | | String | 场景模板（仅模板类任务有值） |
payload | | String | 透传参数 |
credits | | Int | 消耗的 Vidu 积分数 |
creations | | Array | 生成物列表（任务成功时返回） |
| id | String | 生成物 ID |
| url | String | 视频地址（不带水印），24 小时有效 |
| watermarked_url | String | 视频地址（带水印），24 小时有效 |
| cover_url | String | 封面地址，24 小时有效 |
| video | Object | 视频信息：duration、fps、resolution |
响应示例#
{
"id": "{task_id}",
"type": "text2video",
"model": "viduq3-turbo",
"state": "success",
"progress": 100,
"err_code": "",
"err_msg": "",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true,
"bgm": false,
"off_peak": false,
"template": "",
"payload": "",
"credits": 11,
"creations": [
{
"id": "{creation_id}",
"url": "https://example.com/video.mp4",
"watermarked_url": "https://example.com/watermarked.mp4",
"cover_url": "https://example.com/cover.jpeg"
}
]
}
{
"code": "task_not_exist",
"message": "task_not_exist",
"data": null
}
查询任务列表#
返回当前账号最近的 Vidu 任务（默认 10 条），格式为 {"next_page_token": "", "tasks": [ ... ]}，tasks 中每个元素的字段同上。GET /vidu/ent/v2/tasks?task_ids={task_id} 目前不会按 task_ids 过滤，返回的仍是账号最近的任务列表。查询单个任务请使用上方的 /tasks/{task_id}/creations。
