查询任务

GET https://top.qingyuntop.ai/v1/videos/{task_id}

请求头：Authorization: Bearer YOUR_API_KEY。{task_id} 替换为创建接口返回的 id。

status含义处理
queued排队中等待后再次查询。
in_progress生成中继续轮询，不要重新 POST。
completed已完成调用内容接口下载。
failed失败读取 error，修正参数后创建新任务。

建议每 8–15 秒查询一次，并设置总超时。任务 ID 通常有效 24 小时；完成后及时下载。

下载视频

GET https://top.qingyuntop.ai/v1/videos/{task_id}/content

该接口返回视频字节流，仍需携带 Authorization。保存文件时使用 .mp4 扩展名；如果任务失败，不要调用下载接口。

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos/VIDEO_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

常见错误

  • 401 或 403：检查青云 API Key 和模型权限，不要改用阿里供应商 Key。
  • 400：检查模型与参数组合，尤其是旧模型的固定时长、img_url 和 media 的区别。
  • 429 或 5xx：只延迟重试查询请求，不要自动重发创建请求。
  • 素材无法读取：换成公开、未过期的 HTTPS 文件 URL 或 data URL。
  • 下载失败：确认任务状态为 completed；任务和视频 URL 的保存期限有限。