跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://old-docs.kie.ai/llms.txt

Use this file to discover all available pages before exploring further.

当 4K 视频生成任务完成时，系统将通过回调机制通知您生成结果。
Webhook 安全性：为确保回调请求的真实性和完整性，我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南 了解详细实现步骤。

​
回调配置

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

​
回调格式

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

​
回调字段说明

字段类型描述
codeinteger状态码，200 表示成功，500 表示失败
msgstring状态消息，成功时为 “4K Video generated successfully.”，失败时包含错误信息
dataobject | null成功时包含任务结果数据，失败时为 null
data.taskIdstring任务 ID
data.infoobject包含生成结果的详细信息对象
data.info.resultUrlsarray生成的 4K 视频 URL 数组
data.info.imageUrlsarray相关的缩略图或预览图片 URL 数组

​
回调处理

1

验证回调

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

提取结果

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

响应回调

您的服务器应返回 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. 媒体管理: 使用返回的数据进行媒体文件管理和追踪
  5. 存储规划: 4K 视频文件通常很大，请确保有足够的存储空间

​
替代方案

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

轮询查询结果

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