根據原生提交返回的任務 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 行為不同。查詢超時不代表任務失敗，先核對原任務，避免重複提交。