查询生成物
更新时间: 2026/08/27 10:13:38
该接口可以查询任务状态与生成结果。
请求信息
请求 URL
GET /hub/vidu/v2/tasks/{task_id}/creations
请求头
| Header | 必填 | 示例值 |
|---|---|---|
Authorization |
是 | Bearer sk-xxxxx |
请求参数
| 字段 | 位置 | 必填 | 说明 |
|---|---|---|---|
task_id |
path | 是 | 提交成功后返回的任务 ID |
请求示例
httpGET /hub/vidu/v2/tasks/tsk_1234567890/creations
Authorization: Bearer sk-xxxxx
响应信息
响应体
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 任务 ID |
state |
string | 任务状态。常见值:created、queueing、processing、success、failed |
err_code |
string | 错误码,失败时可能返回 |
credits |
string | 消耗量 |
payload |
string | 透传字段 |
bgm |
bool | 是否启用背景音乐 |
off_peak |
bool | 是否启用错峰 |
-
creations |
object[] | 生成结果列表 |
id |
string | 生成物 ID |
url |
string | 生成物地址,通常存在有效期 |
cover_url |
string | 封面地址,通常存在有效期 |
watermarked_url |
string | 带水印生成物地址,通常存在有效期 |
响应示例
json{
"id": "tsk_1234567890",
"state": "success",
"err_code": "",
"credits": "4.000000",
"payload": "",
"bgm": false,
"off_peak": false,
"creations": [
{
"id": "creation_001",
"url": "https://example.com/output.mp4",
"cover_url": "https://example.com/cover.jpg",
"watermarked_url": "https://example.com/output-watermarked.mp4"
}
]
}
错误码
完整列表请参考客户端 API 错误码。
此文档是否对你有帮助?




