KIE.AI
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Market
File Upload APICommon API
Market
File Upload APICommon API
  1. Veo3.1 API
  • 开始使用
  • Market
  • Image Models
    • Seedream
      • Seedream3.0 生成图像
      • Seedream4.0 文生图
      • Seedream4.0 图片编辑
      • Seedream4.5 文生图
      • Seedream4.5 图片编辑
      • Seedream5.0 Lite 文生图
      • Seedream5.0 Lite 图片编辑
    • Z-image
      • 使用 z-image 生成内容
    • Google
      • 使用 nano-banana-2 生成内容
      • Google Imagen4 Fast
      • Google Imagen4 Ultra
      • Google Imagen4
      • Nano Banana 图片编辑
      • Google Nano Banana
      • Nano Banana Pro 图生图
    • Flux-2
      • Flux-2 Pro 图生图
      • Flux-2 Pro 文生图
      • Flux-2 图生图
      • Flux-2 文生图
    • Grok Imagine
      • Grok Imagine 文生图
      • Grok Imagine 图生图
    • GPT Image
      • GPT Image1.5 文生图
      • GPT Image1.5 图生图
    • Topaz
      • Topaz 图像优化
    • Recraft
      • Recraft 背景移除
      • Recraft 图像优化
    • Ideogram
      • Ideogram V3 图片重构
      • Ideogram 角色编辑
      • Ideogram 角色重混
      • Ideogram 角色图像生成
      • Ideogram V3 文生图
      • Ideogram V3 图像编辑
      • Ideogram V3 混合
    • Qwen
      • Qwen 文生图
      • Qwen 图生图
      • Qwen 图片编辑
      • Qwen2 图片编辑
      • Qwen2 文生图
    • 4o Image API
      • 4o Image API 快速开始
      • 4o 图片生成回调
      • 生成4o图像
      • 获取4o图像详情
      • 获取直接下载URL
    • Flux Kontext API
      • Flux Kontext API 快速开始
      • 图像生成或编辑回调
      • 生成或编辑图像
      • 获取图像详情
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
  • Video Models
    • Grok Imagine
      • Grok Imagine 文生视频
      • Grok Imagine 图生视频
      • 放大 Grok Imagine 视频
      • 扩展 Grok Imagine 视频
    • Kling
      • Kling-2.6 文生视频
      • Kling-2.6 图生视频
      • Kling V2.5 Turbo Pro 图生视频
      • Kling V2.5 Turbo Pro 文生视频
      • Kling AI Avatar Standard
      • Kling AI Avatar Pro
      • Kling V2.1 Master 图生视频
      • Kling V2.1 Master 文生视频
      • Kling V2.1 Pro
      • Kling V2.1 Standard
      • kling-2.6 motion-control
      • kling-3.0 motion-control
      • Kling 3.0
    • Bytedance
      • Bytedance Seedance 2.0
      • Bytedance Seedance 2.0 Fast
      • Bytedance Seedance 1.5 Pro
      • Bytedance V1 Pro Fast 图生视频
      • Bytedance V1 Pro 图生视频
      • Bytedance V1 Pro 文生视频
      • Bytedance V1 Lite 图生视频
      • Bytedance V1 Lite 文生视频
    • Hailuo
      • Hailuo 2.3 Pro 图生视频
      • Hailuo 2.3 Standard 图生视频
      • Hailuo Pro 文生视频
      • Hailuo Pro 图生视频
      • Hailuo Standard 文生视频
      • Hailuo Standard 图生视频
    • Sora2
      • Sora2 图生视频
      • Sora2 文生视频
      • Sora2 Pro 图生视频
      • Sora2 Pro 文生视频
      • Sora2 水印移除
      • Sora-2 Pro Storyboard
      • Sora2 - Characters
      • Sora2 - Characters Pro
    • Wan
      • Wan 2.6 - 图转视频
      • Wan 2.6 - 文转视频
      • Wan 2.6 - 视频转视频
      • Wan 2.2 A14B Turbo 图生视频
      • Wan 2.2 A14B Turbo 文生视频
      • Wan 2.2 A14B Turbo 语音转视频
      • Wan 动画移动
      • Wan 动画替换
      • Wan - Flash 图转视频
      • Wan - Flash 视频转视频
      • Wan 2.5 - 图转视频
      • Wan 2.5 - 文转视频
      • Wan 2.7 - 文转视频
      • Wan 2.7 - 图转视频
      • Wan 2.7 - 视频编辑
      • Wan 2.7 - 参考生视频
    • Topaz
      • Topaz视频优化
    • Infinitalk
      • Infinitalk视频生成
    • Runway API
      • Runway API 快速开始
      • AI 视频生成回调
      • AI 视频扩展回调
      • Aleph
        • Aleph 视频生成回调
        • 生成 Aleph 视频
        • 获取 Aleph 视频详情
      • 生成AI视频
      • 获取AI视频详情
      • 延长AI视频
  • Music Models
    • ElevenLabs
      • ElevenLabs对话文生语音V3
      • ElevenLabs Turbo 2.5文生语音
      • ElevenLabs文生语音 多语言V2
      • ElevenLabs语音转文字
      • ElevenLabs音效V2
      • ElevenLabs音频分离
  • Chat Models
    • GPT
      • GPT 5.2
      • GPT 5.4 (response)
    • Claude
      • Claude Haiku 4.5
      • Claude Opus 4.5
      • Claude Opus 4.6
      • Claude Sonnet 4.5
      • Claude Sonnet 4.6
    • Gemini
      • Gemini 2.5 Pro (openai)
      • Gemini 3 Pro (openai)
      • Gemini 3.1 Pro (openai)
      • Gemini 2.5 Flash (openai)
      • Gemini 3 Flash (openai)
      • Gemini 3 Flash
    • Codex
      • GPT Codex
  • Veo3.1 API
    • Veo3.1 API 快速开始
    • Veo3.1 视频生成回调
    • 获取 4K 视频回调
    • 生成veo3.1视频
      POST
    • 扩展veo3.1视频
      POST
    • 获取1080P视频
      GET
    • 获取4K视频
      POST
    • 查询veo3.1视频详情
      GET
  • Suno API
    • Suno API 快速开始
    • Music Generation
      • 生成音乐回调
      • 音乐扩展回调
      • 音频上传和翻唱回调
      • 音频上传和扩展回调
      • 添加伴奏回调
      • 添加人声回调
      • 音乐封面生成回调
      • 替换音乐分区回调
      • 生成音乐
      • 延长音乐
      • 上传并翻唱音乐
      • 上传并扩展音乐
      • 添加伴奏生成音乐
      • 添加人声生成音乐
      • 获取音乐任务详情
      • 获取带时间戳的歌词
      • 提升音乐风格
      • 生成音乐封面
      • 获取音乐封面生成详情
      • 替换音乐分区
      • 生成 Persona
      • 生成混音音乐
    • Lyrics Generation
      • 生成歌词回调
      • 生成歌词
      • 获取歌词任务详情
    • WAV Conversion
      • 转换为WAV格式回调
      • 转换为WAV格式
      • 获取WAV转换详情
    • Vocal Removal
      • 音频分离回调
      • MIDI 生成回调
      • 人声和乐器分离
      • 获取人声和乐器分离详情
      • 从音频生成 MIDI
      • 获取 MIDI 生成详情
    • Music Video Generation
      • MP4生成完成回调
      • 创建音乐视频
      • 获取音乐视频详情
    • Sounds Generation
      • 生成声音
  • 获取任务详情
    GET
  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 请求,格式如下:

1. 成功回调示例#

{
  "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"
      ]
    }
  }
}

2. 失败回调示例#

{
  "code": 500,
  "msg": "The 4K version of this video is unavailable. Please try a different video.",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}

回调字段说明#

字段名类型说明
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