标准任务状态

标准查询地址是 GET https://top.qingyuntop.ai/v1/videos/{task_id}，读取响应顶层的 status：

状态说明下一步
queued网关已接收，等待上游处理约 10 秒后继续查询
in_progress上游正在生成继续查询，不要重新创建
completed视频已生成请求 /v1/videos/{task_id}/content 下载
failed生成失败停止轮询，查看错误和任务日志
unknown当前任务状态无法确定保留任务 ID 和脱敏响应，联系支持

HTTP 200 只表示这次查询请求成功，progress: 100 也不能替代终态判断。标准响应不保证总是带完整 error 字段，失败详情可到控制台任务日志查看。

最小排查示例

把 task_veo_example 替换为真实创建响应中的 id。以下代码只读取任务状态。

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

常见 HTTP 错误

现象检查与处理
HTTP 400核对完整模型 ID、seconds 是否为 4/6/8，以及高清是否保持 8 秒；分辨率写入 metadata.resolution，比例写入 metadata.aspectRatio。
HTTP 401 / 403检查 Authorization: Bearer ...、Key 是否有效、账号是否有该模型分组权限；不要把 Google Key 当作青云 Key。
模型不存在先请求 GET /v1/models，再核对价格页中的模型和分组。
任务不存在确认 ID 来自创建响应、使用同一个账号，并且没有混用 /v1/videos 与旧通用协议。
HTTP 413 / 415图片使用真实 PNG/JPEG，核对 MIME 和大小；multipart 字段使用 input_reference，不要覆盖 boundary。
HTTP 429降低创建和轮询频率，遵循 Retry-After，必要时逐步退避。
HTTP 5xx、连接中断、超时查询失败可用原 ID 稍后重试；创建请求超时先查任务日志，避免重复创建。
图片没有生效multipart 用 input_reference；JSON 用 images[0] 的 data URL。普通 HTTPS 图片 URL 不保证被读取。
failed 但没有原因查看任务日志；按安全过滤、人物或素材限制调整提示词或图片，不要反复提交同一失败请求。
completed 但下载失败使用 /content、同一有效 Key，并确认任务还在临时保存期限内；不要把 JSON 错误当视频保存。

完成后出现 artifact_not_found

如果任务已是 completed，但下载返回 artifact_not_found，请保留任务 ID 联系支持，不要立刻重新生成。除保存期限外，也可能是服务端未正确识别上游结果。

若路径、权限和文件期限均无问题，可能是生成结果未能正常返回。请向本站支持提供任务 ID、模型、提交时间和脱敏错误；重复生成无法恢复原任务文件，且可能产生额外费用。

旧入口和上游状态如何对应

旧程序的 /v1/video/generations/{task_id} 可能返回 data.status 为 processing、succeeded、NOT_START、IN_PROGRESS、SUCCESS 或 FAILURE，且响应可能包在 data 中。Google 官方异步 operation 使用 done 和 error。这些名称不属于标准 /v1/videos 状态；新项目只按本页的四个标准状态处理。

如果你从 Apifox 复制了 /v1/video/create、/v1/video/query?id=...、veo3.1-fast 或 aspect_ratio，请先改为 https://top.qingyuntop.ai/v1/videos、完整模型 ID、seconds 和 metadata。当前网关对旧地址返回 Invalid URL，这和 API Key 是否有效是两件事。

联系支持时提供的信息

请提供任务 ID、完整模型名、提交时间和时区、请求路径、HTTP 状态码及脱敏错误信息。请求体可以去掉 Key 和图片内容后再提供；不要发送完整 API Key、Authorization 请求头或私有图片 Base64。

两种对外接口

本站提供统一视频格式和 Responses 格式，不提供本目录中的 Google 原生 operation 创建和查询方式。Responses 查询使用 resp_…，下载使用返回的 metadata.task_id。