Dreamina Tasks API 的對接和使用
Dreamina Tasks API 用於查詢 Dreamina Video Generation API 創建的數位人視頻任務的執行結果。當你在生成接口中傳入callback_url 或 async: true 時，接口會立即返回一個 task_id，你可以通過本接口按 task_id 或 trace_id 輪詢任務狀態與最終視頻地址。本接口免費。
申請流程
要使用 Dreamina 系列 API，首先到 Ace Data Cloud 控制台 獲取你的 API Token，留作備用。 如果你尚未登錄或註冊，會自動跳轉到登錄頁面邀請你註冊和登錄，完成後會自動返回當前頁面。 一個 API Token 即可調用平台所有服務，無需為每個服務單獨申請。 首次申請會贈送免費額度，可免費體驗；額度不足時可在 控制台 充值通用餘額。請求參數
Request Headersaccept：指定接收 JSON 格式的響應結果，填寫application/json。authorization：調用 API 的密鑰，格式為Bearer {token}。content-type：填寫application/json。
查詢單個任務時，id與trace_id至少提供一個。
查詢單個任務
CURL
Python
響應示例
請求成功後，API 返回該任務的詳情。request 是創建任務時的請求體，response 是任務完成後的響應體，其中 data.video_url 為生成的數位人視頻地址：
id：本次視頻生成任務的唯一 ID。trace_id：本次請求的追蹤 ID，用於問題排查。request：創建任務時提交的請求內容。response：任務完成後返回的響應內容。當response.data.status為done時，response.data.video_url即為最終視頻地址。created_at：任務創建時間，Unix 時間戳（秒，浮點）。started_at：任務開始執行時間，Unix 時間戳（秒，浮點）。finished_at：任務完成時間，Unix 時間戳（秒，浮點）。任務未完成時不返回該字段。elapsed：任務執行耗時，單位為秒（浮點，保留 3 位小數）。任務未完成時不返回該字段。
若任務尚未完成，status可能為非done狀態；若任務不存在或尚未生成結果，接口會返回空對象{}，請稍後重試。
批量查詢任務
將action 設為 retrieve_batch，並傳入 ids 陣列：
items 為批量任務詳情陣列（每個元素與單個查詢結果格式一致），count 為本次返回的任務數量。
錯誤處理
調用 API 遇到錯誤時，會返回對應的錯誤碼和信息：400 bad_request：請求錯誤，可能缺少id/trace_id等必要參數。401 invalid_token：未授權，授權令牌無效或缺失。429 too_many_requests：請求過多，已超出速率限制。500 api_error：伺服器內部錯誤。
錯誤響應示例
結論
通過本文檔，你已經了解如何使用 Dreamina Tasks API 查詢單個或批量數位人視頻任務的結果。配合生成接口的callback_url / async 非同步模式，即可實現穩定的輪詢拉取。如有任何問題，請隨時聯繫我們的技術支持團隊。