Veo3.1 视频生成回调
当视频生成完成时，系统会调用此回调通知结果。
callBackUrl 参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：Success Callback
Failure Callback
{
"code": 200,
"msg": "Video generated successfully.",
"data": {
"taskId": "veo_task_abcdef123456",
"promptJson": "{\"aspectRatio\":\"16:9\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"enableTranslation\":true,\"model\":\"veo3_fast\",\"prompt\":\"cat\"}",
"info": {
"resultUrls": ["http://example.com/video1.mp4"],
"originUrls": ["http://example.com/original_video1.mp4"],
"resolution": "1080p",
"seeds": [21753],
"media_ids": ["e5895558-a627-408a-845c-22e33a775670"],
"has_audio_list": [true]
},
"creditsConsumed": 60
}
}状态码说明
参数说明
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
code | integer | 是 | 回调状态码，表示任务处理结果 |
msg | string | 是 | 状态消息，提供详细的状态描述 |
data.taskId | string | 是 | 任务 ID，与您提交任务时返回的 taskId 一致 |
data.info.resultUrls | array | 否 | 生成的视频URL数组（仅成功时返回） |
data.info.originUrls | array | 否 | 原始视频URL数组（仅成功时返回） |
data.info.resolution | string | 否 | 视频分辨率信息（仅成功时返回），表示生成视频的分辨率 |
状态码详情
| 状态码 | 描述 |
|---|---|
| 200 | 成功 - 视频生成任务成功 |
| 400 | 客户端错误 - 提示词违反内容政策、无法获取图片（请验证访问限制）、不安全的图片上传 |
| 500 | 内部错误 - 请稍后重试，内部错误或超时 |
| 501 | 失败 - 视频生成任务失败 |
回调接收示例
Node.js
Python
PHP
最佳实践
回调 URL 配置建议
1.
2.
3.
4.
5.
6.
7.
8.
重要提醒
故障排查
Veo3 特定注意事项
Veo3 视频生成特性
1.
2.
3.
4.
5.
6.