功能介绍

使用原生图生创建接口返回的 data.task_id 查询任务，保留其原生业务响应结构。创建与查询的类型必须对应。

鉴权与操作步骤

所有请求发送到 https://top.qingyuntop.ai。在请求头填写 Authorization: Bearer YOUR_API_KEY，将 YOUR_API_KEY 替换为青云TOP API 控制台创建的 API Key；Bearer 与密钥之间保留一个空格。

  1. 使用创建响应中已保存的标识，携带鉴权请求头查询任务。
  2. 按状态继续等待或处理错误；成功且产物就绪后下载。无需再次创建任务。

GET 查询与下载不需要请求体。示例中的占位密钥需替换为你的 API Key。实际业务请在服务端保存密钥，不要放进公开网页。

查询接口

GET /kling/v1/videos/image2video/{task_id}，无请求体。填写创建响应的本站 data.task_id，不用 external_task_id 代替。

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

同时检查 HTTP 状态与 code=0。主要字段：data.task_id为本站任务ID；data.task_status为状态；data.task_status_msg为状态/失败说明；data.task_result.videos为结果数组。原生时间戳为毫秒，不要和统一视频字段的表现混用。

task_status处理方式
submitted已受理，稍后重查
processing生成中，继续查询
succeed成功，可以读取 videos 或下载产物
failed失败，读取 task_status_msg

建议每5–10秒查询一次。达到业务等待期限后保留ID稍后再查，不要重复提交。本入口只支持单任务查询，不提供批量列表或按 external_task_id 查询。

下载视频

成功时可以读取 data.task_result.videos 数组中的URL并及时保存。不要把本站Key发送给厂商CDN。推荐通过本站产物接口使用同一Key下载，本接口默认提供第一个视频，key为video：

curl --fail-with-body "https://top.qingyuntop.ai/v1/tasks/YOUR_TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

先使用 GET /v1/tasks/{task_id}/artifacts 确认产物已就绪。文件下载响应是字节，不能按JSON解析。不同接口的ID保持原样，不自行转换前缀。