跳转到主要内容
当 4K 视频生成任务完成时，系统将通过回调机制通知您生成结果。

​
回调配置

在请求 4K 视频生成时，您可以通过 callBackUrl 参数配置回调地址： 
{
  "taskId": "veo_task_abcdef123456",
  "index": 0,
  "callBackUrl": "https://your-domain.com/api/4k-callback"
}

​
回调格式

当 4K 视频生成完成时，系统将向您配置的回调 URL 发送 POST 请求，请求体包含以下格式： 
{
  "code": 200,
  "msg": "Video generated successfully.",
  "data": {
    "taskId": "6060e30319dbb51ce35a43bd9312f476",
    "fallbackFlag": false,
    "info": {
      "resultUrls": [
        "https://tempfile.aiquickdraw.com/v/6060e30319dbb51ce35a43bd9312f476_1768391941.mp4"
      ],
    }
  }
}

​
回调字段说明

字段类型描述
codeinteger状态码，200 表示成功，500 表示失败
msgstring状态消息，成功时为 “Success”，失败时包含错误信息
dataobject | null成功时包含任务结果数据，失败时为 null
data.taskIdstring任务 ID
data.resultUrlsarray生成的 4K 视频 URL 数组
data.mediaIdsarray媒体 ID 数组
data.imageUrlsarray相关图片 URL 数组

​
回调处理

1

验证回调

检查 code 字段确认生成是否成功
2

提取结果

从 data.result_urls 获取生成的 4K 视频下载地址
3

处理媒体

使用 media_ids 进行媒体管理和追踪
4

响应回调

您的服务器应返回 200 状态码确认收到回调

​
错误处理

如果 4K 视频生成过程中出现错误，回调将返回错误状态码和相应的错误消息。目前支持的错误情况包括：
  • 500: 4K 版本不可用 - “The 4K version of this video is unavailable. Please try a different video.”
确保您的回调端点能够处理重复回调，避免重复处理同一任务。

​
最佳实践

​
4K 视频生成回调处理建议

  1. 及时下载: 4K 视频文件较大，URL 可能有有效期限制，请及时下载并保存到本地存储
  2. 幂等处理: 同一任务可能收到多次回调，确保处理逻辑是幂等的
  3. 错误重试: 如果收到 4K 不可用的错误，可以尝试使用其他视频或联系技术支持
  4. 媒体管理: 使用返回的 mediaIds 进行媒体文件管理和追踪
  5. 存储规划: 4K 视频文件通常很大，请确保有足够的存储空间

​
替代方案

如果无法使用回调机制，您也可以使用轮询方式：

轮询查询结果

使用获取视频详情接口定期查询 4K 视频生成任务状态。