根据原生提交返回的任务 ID 查询状态、视频地址和实际用量。
GET /api/v1/tasks/{task_id}
鉴权: Bearer sk-xxx
使用提交返回的 `output.task_id` 查询本站保存的原生万相 3.0 任务。必须使用同一账号的 API Key。`PENDING`／`RUNNING` 时继续查询同一 ID，`SUCCEEDED` 时读取 `output.video_url` 和顶层 `usage`；不要为查询结果重复提交 POST。此接口不需要 `X-DashScope-Async` 请求头。
task_id | string | required | 原生提交响应中的 `output.task_id`。 |
200 — 返回原生任务状态；示例为成功终态，处理中与失败响应见下方附录。401 — API Key 缺失或无效。404 — 任务不存在或不属于当前账号。curl --request GET 'https://api.router.ai/api/v1/tasks/00000000-0000-4000-8000-000000000001' \
-H 'Authorization: Bearer <TOKEN>'## 查询原生任务 提交响应中的 `output.task_id` 是唯一查询标识。使用同一账号的 API Key 查询本平台创建的任务： ```bash curl --request GET 'https://api.router.ai/api/v1/tasks/00000000-0000-4000-8000-000000000001' \ -H 'Authorization: Bearer <TOKEN>' ``` 查询请求只需 `Authorization: Bearer <TOKEN>`；路径中的 ID 替换为本次提交返回的 `output.task_id`。任务生成可能需要数分钟，可间隔约 15 秒查询同一个任务。 ### 查询成功响应示例（HTTP 200） ```json { "request_id": "00000000-0000-4000-8000-000000000002", "output": { "task_id": "00000000-0000-4000-8000-000000000001", "task_status": "SUCCEEDED", "submit_time": "2026-01-01 10:00:00.000", "scheduled_time": "2026-01-01 10:00:01.000", "end_time": "2026-01-01 10:00:30.000", "orig_prompt": "蓝色圆点沿白色背景向右移动，简洁动画。", "video_url": "https://example.com/generated-video.mp4" }, "usage": { "video_count": 1, "duration": 2.0, "input_video_duration": 0.0, "output_video_duration": 2.0, "fps": 30, "SR": 480, "ratio": "16:9" } } ``` `output` 中的 `submit_time`、`scheduled_time`、`end_time` 和 `orig_prompt` 来自百炼实际返回；`output.video_url` 是成功后的视频临时地址，应及时保存。顶层 `usage` 只在成功且有用量时出现：`video_count` 是视频数量，`duration` 是计费总时长，`input_video_duration`／`output_video_duration` 分别为参考视频输入与生成输出时长，`fps` 是帧率，`SR` 是实际输出分辨率数值，`ratio` 是宽高比。秒数是 JSON 数字，整数秒可能显示为 `2` 或 `2.0`。无参考视频时输入时长为 0；有参考视频时总时长包含输入和输出。 ### 处理中与失败示例 `PENDING`／`RUNNING` 时尚无成片和成功用量，例如： ```json { "request_id": "00000000-0000-4000-8000-000000000002", "output": { "task_id": "00000000-0000-4000-8000-000000000001", "task_status": "PENDING" } } ``` 已找到任务但执行失败时，`output` 中可能有 `code`、`message`，例如： ```json { "request_id": "00000000-0000-4000-8000-000000000002", "output": { "task_id": "00000000-0000-4000-8000-000000000001", "task_status": "FAILED", "code": "InvalidParameter", "message": "Task failed due to invalid parameters." } } ``` 本平台对不存在或不属于当前账号的任务返回 HTTP 404 `TaskNotFound`；百炼官网在其任务过期示例中展示 `UNKNOWN`，与本站的 404 行为不同。查询超时不代表任务失败，先核对原任务，避免重复提交。