KIE.AI
old-model
  • All Model
  • old-model
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
old-model
  • All Model
  • old-model
old-model
  • All Model
  • old-model
Suno API4o Image APIVeo3.1 API
Runway APIFlux Kontext API
Suno API4o Image APIVeo3.1 API
Runway APIFlux Kontext API
  1. Veo3.1 API
  • Veo3.1 API 快速开始
  • Veo3.1 视频生成回调
  • 获取 4K 视频回调
  • 生成veo3.1视频
    POST
  • 查询veo3.1视频详情
    GET
  • 获取1080P视频
    GET
  • 获取4K视频
    POST
  • 扩展veo3.1视频
    POST
  1. Veo3.1 API

获取 4K 视频回调

当 4K 视频生成任务完成时,系统会调用此回调接口来通知您最终结果。
4K 视频生成任务完成后,系统将通过回调机制自动将结果推送到您的服务器,无需您持续轮询接口状态。
Webhook 安全性:为确保回调请求的真实性和完整性,我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南 了解详细实现步骤。

回调配置#

在请求 4K 视频生成接口时,请在 callBackUrl 参数中配置您的接收地址:
{
  "taskId": "veo_task_abcdef123456",
  "index": 0,
  "callBackUrl": "https://your-domain.com/api/4k-callback"
}

回调请求格式#

任务完成后,系统将向您配置的 URL 发送一个 POST 请求,格式如下:
成功回调
失败回调
{
"code": 200,
"data": {
"creditsConsumed": 120,
"info": {
  "imageUrls": [
    "http://example.com/image.png"
  ],
  "resultUrls": [
    "http://example.com/video1.mp4"
  ]
},
"taskId": "2b1b13eca3e8b8bbd5a88610d29dfd51"
},
"msg": "4K Video generated successfully."
}

回调字段说明#

字段名类型说明
codeinteger状态码。200: 成功;500: 失败。
msgstring状态描述。成功显示成功信息,失败显示具体错误原因。
dataobject任务结果数据(仅在成功时包含完整内容)。
∟ taskIdstring任务唯一标识符。
∟ info.resultUrlsarray生成的 4K 视频下载地址数组。
∟ info.imageUrlsarray相关的缩略图或预览图地址数组。

回调处理流程#

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 回调处理建议
及时下载:4K 视频文件体积较大且链接有有效期限制,请在接收回调后尽快下载并转存。
幂等处理:同一任务可能触发多次回调,请确保您的逻辑支持重复接收。
资源追踪:使用返回的 taskId 进行媒体文件的关联管理。
存储规划:4K 视频占用存储空间较大,请预先规划好您的磁盘容量。

替代方案#

如果您无法使用回调机制,也可以使用主动查询:
轮询查询结果
使用“获取视频详情”接口定期查询 4K 视频生成任务的状态。

如果您在集成过程中遇到任何问题,请联系我们的技术支持:support@kie.ai
Previous
Veo3.1 视频生成回调
Next
生成veo3.1视频
Built with