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 异步模式，即可实现稳定的轮询拉取。如有任何问题，请随时联系我们的技术支持团队。