KIE.AI
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Market
File Upload APICommon API
Market
File Upload APICommon API
  1. Aleph
  • 开始使用
  • 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 视频
          POST
        • 获取 Aleph 视频详情
          GET
      • 生成AI视频
        POST
      • 获取AI视频详情
        GET
      • 延长AI视频
        POST
  • 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视频
    • 扩展veo3.1视频
    • 获取1080P视频
    • 获取4K视频
    • 查询veo3.1视频详情
  • 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. Aleph

Aleph 视频生成回调

处理 Runway Alpeh 视频生成完成的 webhook 通知

概述#

回调提供了一种高效的方式,当您的 Runway Aleph 视频生成任务完成时接收通知。您的应用程序可以通过 webhook 接收即时通知,无需重复轮询 API,当视频准备就绪时立即得到通知。
回调是生产应用程序的推荐方法,因为它们减少了 API 调用,提高了响应时间,并提供任务完成的即时通知。
Webhook 安全性:为确保回调请求的真实性和完整性,我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南 了解详细实现步骤。

回调工作原理#

工作流程#

1.
提交生成请求
在您的视频生成请求中包含 callBackUrl 参数:
{
  "prompt": "转换为梦幻水彩画风格,配以柔和流动的运动效果",
  "videoUrl": "https://example.com/input-video.mp4",
  "callBackUrl": "https://your-app.com/webhook/aleph-callback"
}
2.
接收任务 ID
API 立即返回任务 ID,同时开始处理:
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
  }
}
3.
处理回调
生成完成时,我们的系统会向您的回调 URL 发送包含结果的 POST 请求。

回调负载#

视频生成完成时,您将收到包含以下负载的 POST 请求:

成功回调#

{
  "code": 200,
  "msg": "success",
  "data": {
    "result_video_url": "https://file.com/k/xxxxxxx.mp4",
    "result_image_url": "https://file.com/m/xxxxxxxx.png"
  },
  "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}

参数说明#

参数类型必需说明
codeinteger是指示结果的状态码
msgstring是描述结果的可读消息
data.result_video_urlstring是访问和下载生成视频的 URL(有效期 14 天)
data.result_image_urlstring是生成视频的缩略图 URL
taskIdstring是来自您生成请求的原始任务 ID

状态码详情#

状态码说明
200视频生成成功
400由于内容政策或技术问题生成失败

错误回调#

{
  "code": 400,
  "msg": "您的提示词被我们的 AI 审查员捕获。请调整后重试!",
  "data": null,
  "taskId": "ee603959-debb-48d1-98c4-a6d1c717eba6"
}

实现回调端点#

以下是用流行编程语言实现回调端点的示例:
Node.js/Express
Python/Flask
PHP

安全最佳实践#

验证回调来源
处理重复回调
错误处理和重试逻辑

测试回调#

本地开发#

对于本地测试,使用 ngrok 等工具暴露您的本地服务器:

Webhook 测试工具#

Webhook.site
生成临时 URL 来测试回调负载
RequestBin
检查和调试 webhook 请求

故障排除#

未收到回调
重复或丢失的回调
回调负载问题

相关文档#

生成 Aleph 视频
学习如何创建带有回调的视频生成请求
获取任务详情
检查任务状态的替代轮询方法

需要帮助
请联系我们的支持团队 support@kie.ai 获取回调实现的帮助。
Previous
AI 视频扩展回调
Next
生成 Aleph 视频
Built with