Veo3.1 视频生成回调
当视频生成完成时，系统会调用此回调通知结果。
callBackUrl 参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：Success Callback
Failure Callback
Fallback Failed Callback
Fallback Success Callback
{
"code": 200,
"msg": "Video generated successfully.",
"data": {
"taskId": "veo_task_abcdef123456",
"promptJson": "{\"aspectRatio\":\"16:9\",\"callBackUrl\":\"\\https://b7af305f36d6.ngrok-free.app/api/v1/modify/test\",\"enableFallback\":false,\"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]
},
"fallbackFlag": false,
"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 | 否 | 视频分辨率信息（仅成功时返回），表示生成视频的分辨率 |
data.fallbackFlag | boolean | 否 | 是否通过托底模型生成。true 表示使用了备用模型生成，false 表示使用主模型生成 |
状态码详情
| 状态码 | 描述 |
|---|---|
| 200 | 成功 - 视频生成任务成功 |
| 400 | 客户端错误 - 提示词违反内容政策、仅支持英文提示词、无法获取图片（请验证访问限制）、不安全的图片上传 |
| 422 | 托底失败 - 当未开启托底且遇到特定错误时返回，错误信息格式为：Your request was rejected by Flow... |
| 500 | 内部错误 - 请稍后重试，内部错误或超时 |
| 501 | 失败 - 视频生成任务失败 |
托底机制说明：
enableFallback 且遇到以下错误时，系统会尝试使用备用模型：托底功能说明
启用条件
1.
enableFallback 参数设置为 true2.
16:93.
托底限制
错误处理
注意
回调接收示例
Node.js
Python
PHP
最佳实践
回调 URL 配置建议
1.
2.
3.
4.
5.
6.
7.
8.
重要提醒
故障排查
Veo3 特定注意事项
Veo3 视频生成特性
1.
2.
3.
4.
5.
6.