查询接口与鉴权

GET https://top.qingyuntop.ai/ali/api/v1/tasks/{task_id}

请求头：Authorization: Bearer YOUR_API_KEY。不需要请求体，也不需要 X-DashScope-Async。把 task_id 替换为创建响应的 output.task_id。

返回字段和状态

字段说明
request_id上游请求标识，排查错误时可保留。
output.task_id青云公共任务 ID，与创建响应一致；请原样使用。
output.task_status原生状态，见下表。
output.video_url成功时的临时视频下载链接；部分响应可能位于 output.results.video_url。
output.code、output.message任务失败原因；请求级错误也可能放在顶层 code / message。
usage上游用量信息，字段随模型变化，实际扣费以青云账单为准。
状态后续处理
PENDING排队中，约 10 秒后重查。
RUNNING生成中，继续等待。
SUCCEEDED下载并保存视频。
FAILED、CANCELED、UNKNOWN按失败处理并检查错误信息；不要无限轮询。

返回 CANCELED 不代表本目录提供取消任务接口。当前只说明创建、单任务查询和内容下载，不提供列表、批量查询、取消或删除调用。

{
  "request_id": "request_example",
  "output": {
    "task_id": "task_wan_example",
    "task_status": "SUCCEEDED",
    "video_url": "https://example.com/temporary-result.mp4"
  },
  "usage": {"video_count": 1, "duration": 5, "SR": 720}
}

这是字段示意，不是真实生成结果。原生查询保留上游 output 中的结果字段；统一格式则将任务包装为 video 对象，Responses 包装为 response 对象，不要混用它们的状态字段。

查询、轮询与下载代码

下例通过青云 /v1/videos/{task_id}/content 下载同一视频任务，继续携带青云 Key。也可以使用原生响应中的临时 video_url 下载，但访问外部素材 URL 时不要附带青云 Authorization。

curl --fail-with-body "https://top.qingyuntop.ai/ali/api/v1/tasks/task_wan_example" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos/task_wan_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-video.mp4

错误处理与保存期限

情况排查方式
401 / 403检查青云 API Key、账号权限和模型分组。
创建 400根据模型清单检查 resolution、duration、size 和输入组合。21:9 本接口不接受。
查询 404检查是否使用青云返回的 ID、是否属于相同账号，以及是否使用完整 /ali 路径。
429 / 查询 5xx延迟重试 GET，增加查询间隔；不要重发 POST 创建。
素材无法读取检查 URL 是否直达文件、是否过期、是否要求登录，以及素材尺寸和时长。
SUCCEEDED 但下载失败确认 video_url 存在；已过期的上游视频无法通过内容代理恢复。

官方上游任务和视频链接通常有效 24 小时。青云任务记录的保留不代表视频永久保存；成功后立即下载。创建请求超时且没有 ID 时，先查任务日志，避免重复创建与扣费。