当 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"
]
}
}
}
回调字段说明
| 字段 | 类型 | 描述 |
|---|
code | integer | 状态码，200 表示成功，500 表示失败 |
msg | string | 状态消息，成功时为 “4K Video generated successfully.”，失败时包含错误信息 |
data | object | null | 成功时包含任务结果数据，失败时为 null |
data.taskId | string | 任务 ID |
data.info | object | 包含生成结果的详细信息对象 |
data.info.resultUrls | array | 生成的 4K 视频 URL 数组 |
data.info.imageUrls | array | 相关的缩略图或预览图片 URL 数组 |
回调处理
提取结果
从 data.info.resultUrls 获取生成的 4K 视频下载地址
响应回调
您的服务器应返回 200 状态码确认收到回调
错误处理
如果 4K 视频生成过程中出现错误，回调将返回错误状态码和相应的错误消息。目前支持的错误情况包括：
- 500: 4K 版本不可用 - “The 4K version of this video is unavailable. Please try a different video.”
确保您的回调端点能够处理重复回调，避免重复处理同一任务。
最佳实践
4K 视频生成回调处理建议
- 及时下载: 4K 视频文件较大，URL 可能有有效期限制，请及时下载并保存到本地存储
- 幂等处理: 同一任务可能收到多次回调，确保处理逻辑是幂等的
- 错误重试: 如果收到 4K 不可用的错误，可以尝试使用其他视频或联系技术支持
- 媒体管理: 使用返回的数据进行媒体文件管理和追踪
- 存储规划: 4K 视频文件通常很大，请确保有足够的存储空间
替代方案
如果无法使用回调机制，您也可以使用轮询方式：
轮询查询结果
使用获取视频详情接口定期查询 4K 视频生成任务状态。
