docs.emix.ai
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Market
File Upload API
Market
File Upload API
  1. Market
  • Webhook 安全校验
  • 开始使用
  • Market
  • Image Models
    • Topaz
      • Topaz 图像优化
    • Seedream
      • Seedream3.0 生成图像
      • Seedream4.0 文生图
      • Seedream4.0 图片编辑
      • Seedream4.5 文生图
      • Seedream4.5 图片编辑
      • Seedream5.0 Lite 文生图
      • Seedream5.0 Lite 图片编辑
      • Seedream5.0 Pro 文生图
      • Seedream5.0 Pro 图片编辑
      • Seedream5.0 Pro 图层分离
      • Seedream5.0 Flash 文生图
      • Seedream5.0 Flash 图片编辑
      • Seedream5.0 Flash 图层分离
      • Seedream5.5 文生图
      • Seedream5.5 图片编辑
      • Seedream5.5 图层分离
    • Google
      • Google Imagen4 Fast
      • Google Imagen4 Ultra
      • Google Imagen4
      • Google Nano Banana
      • Nano Banana Pro 图生图
      • 使用 nano-banana-2 生成内容
      • Nano Banana 2 Lite
      • 使用 Nano Banana 2.1 生成图片
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
    • Z-image
      • 使用 z-image 生成内容
    • Flux-2
      • Flux-2 Pro 图生图
      • Flux-2 Pro 文生图
      • Flux-2 图生图
      • Flux-2 文生图
    • Grok Imagine
      • Grok Imagine 文生图
      • Grok Imagine 图生图
      • Grok Imagine Image 2.0 文生图
      • Grok Imagine Image 2.0 Segment Map
      • Grok Imagine Image 2.0 图片编辑
    • GPT Image
      • GPT Image 2.6 Flare 文生图
      • GPT Image 2.6 Flare 图生图
      • GPT Image 2.6 Sunburst 文生图
      • GPT Image 2.6 Sunburst 图生图
      • GPT Image 2.6 Economy 文生图
      • GPT Image 2.6 Economy 图生图
      • GPT Image1.5 文生图
      • GPT Image1.5 图生图
      • GPT Image 2 文生图
      • GPT Image 2 图生图
      • GPT Image 2.5 Sunburst 文生图
      • GPT Image 2.5 Flare 文生图
      • GPT Image 2.5 Sunburst 图生图
      • GPT Image 2.5 Flare 图生图
    • Recraft
      • Recraft 背景移除
      • Recraft 图像优化
    • Ideogram
      • Ideogram V3 图片重构
      • Ideogram 角色编辑
      • Ideogram 角色重混
      • Ideogram 角色图像生成
      • Ideogram V3 文生图
      • Ideogram V3 图像编辑
      • Ideogram V3 混合
    • Qwen
      • Qwen 文生图
      • Qwen 图生图
      • Qwen 图片编辑
      • Qwen2 图片编辑
      • Qwen2 文生图
      • Qwen 2.1 文生图
      • Qwen 2.1 图生图
      • Qwen3 Pro 文生图
      • Qwen3 文生图
      • Qwen3 Pro 图生图
      • Qwen3 图生图
    • 4o Image API
      • 4o Image API 快速开始
      • 4o 图片生成回调
      • 生成4o图像
      • 获取4o图像详情
      • 获取直接下载URL
    • Flux Kontext API
      • Flux Kontext API 快速开始
      • 图像生成或编辑回调
      • 生成或编辑图像
      • 获取图像详情
    • Flux-3
      • FLUX 3 Klein 文生图
      • FLUX 3 Klein 图像编辑
    • Emix
      • Emix - 图片放大
    • Kling
      • Kling 4.0 Image
      • Kling 4.0 Long Image
    • MiniMax H3-Image
      • MiniMax H3 文生图
      • MiniMax H3 图像编辑
  • Video Models
    • Omnihuman 1.5
      • OmniHuman 2.0
      • OmniHuman 1.5
      • Omnihuman 1.5 主体识别
      • Omnihuman 1.5 主体检测
    • Hailuo
      • Hailuo 2.3 Pro 图生视频
      • Hailuo 2.3 Standard 图生视频
      • Hailuo Pro 文生视频
      • Hailuo Pro 图生视频
      • Hailuo Standard 文生视频
      • Hailuo Standard 图生视频
    • Topaz
      • Topaz视频优化
    • Runway API
      • Runway 图生视频
      • Runway 文生视频
      • Runway 视频扩展
    • Wan
      • Wan 2.6 Flash - 图生视频
      • Wan 2.6 Flash - 视频生视频
      • 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 2.5 - 图转视频
      • Wan 2.5 - 文转视频
      • Wan 2.7 - 文转视频
      • Wan 2.7 - 图转视频
      • Wan 2.7 - 视频编辑
      • Wan 2.7 - 参考生视频
      • Wan 3.0 - 生成视频
      • Wan 3.0 - 高速生成视频
    • Bytedance
      • Bytedance Seedance 2.0
      • Bytedance Seedance 2.0 Fast
      • Bytedance Seedance 2.0 Mini
      • Bytedance Seedance 1.5 Pro
      • Bytedance V1 Pro Fast 图生视频
      • Bytedance V1 Pro 图生视频
      • Bytedance V1 Pro 文生视频
      • Bytedance V1 Lite 文生视频
      • Bytedance V1 Lite 图生视频
      • Bytedance Seedance 2.5 Flash
      • Bytedance Seedance 2.5
      • Bytedance Seedance 2.5 Draft
    • HappyHorse
      • HappyHorse-文生视频
      • HappyHorse-图生视频
      • HappyHorse-参考生视频
      • HappyHorse-视频编辑
      • HappyHorse 1.1 图生视频
      • HappyHorse 1.1 文生视频
      • HappyHorse 1.1 参考图生成视频
    • Grok Imagine
      • Grok Imagine 文生视频
      • Grok Imagine 图生视频
      • 放大 Grok Imagine 视频
      • 扩展 Grok Imagine 视频
      • Grok Imagine Video 1.5 Preview
    • Kling
      • Kling 4.0 全能参考生成视频
      • Kling 4.0 关键帧生成视频
      • Kling 4.0 Flash 关键帧生成视频
      • Kling 4.0 Flash 参考生成视频
      • 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
      • Kling V3 Turbo 文生视频
      • Kling V3 Turbo 图生视频
      • Kling 3.0 Omni 文生视频
      • Kling 3.0 Omni 图生视频
      • Kling 3.0 Omni Transformation
      • Kling 3.0 Omni Reference-To-Video
    • Veo3.1 API
      • Veo3.1 API 快速开始
      • Veo3.1 视频生成回调
      • 获取 4K 视频回调
      • 生成veo3.1视频
      • VEO 3.1 扩展视频
      • 获取1080P视频
      • 获取4K视频
      • 查询veo3.1视频详情
      • VEO 3.1 文生视频
      • VEO 3.1 图生视频
      • VEO 3.1 参考生视频
    • Gemini Omni
      • Gemini Omni 1.1 Flash
      • Gemini Omni 1.2 Flash
      • Gemini Omni Flash 1.2 视频延长
      • Gemini Omni 生视频
      • Gemini Omni Audio 生语音
      • Gemini Omni Character 生角色
    • Volcengine
      • Volcengine 视频对口型
    • PixVerse
      • PixVerse V6 Max 图生视频
      • PixVerse V6 Max 文生视频
      • PixVerse V6 文生视频
      • PixVerse V6 图生视频
      • PixVerse V6 首尾帧/转场
      • PixVerse V6 视频扩展
      • PixVerse V6 Reference-to-video/参考图生成
    • MiniMax-H3
      • MiniMax H3 文生视频
      • MiniMax H3 图生视频
      • MiniMax H3 参考生视频
    • Vidu
      • Vidu Q4 图生视频
      • Vidu Q4 参考生视频
    • Emix
      • Emix - 视频放大
    • LTX
      • LTX 2.5 Fast 文生视频
      • LTX 2.5 Fast 图生视频
      • LTX 2.5 Fast 音频生视频
      • LTX 2.5 Pro 文生视频
      • LTX 2.5 Pro 图生视频
  • Music Models
    • ElevenLabs
      • ElevenLabs对话文生语音V3
      • ElevenLabs Turbo 2.5文生语音
      • ElevenLabs文生语音 多语言V2
      • ElevenLabs语音转文字
      • ElevenLabs音效V2
      • ElevenLabs音频分离
    • Suno API
      • Music Generation
        • 生成音乐回调
        • 音乐扩展回调
        • 添加伴奏回调
        • 添加人声回调
        • 音乐封面生成回调
        • 替换音乐分区回调
        • 音频上传和扩展回调
        • 音频上传和翻唱回调
        • 生成音乐
        • 延长音乐
        • 上传并翻唱音乐
        • 上传并扩展音乐
        • 添加伴奏生成音乐
        • 添加人声生成音乐
        • 获取带时间戳的歌词
        • 提升音乐风格
        • 替换音乐分区
        • 生成音乐封面
        • 生成混音音乐
        • 生成 Persona
      • Lyrics Generation
        • 生成歌词回调
        • 生成歌词
      • WAV Conversion
        • 转换为WAV格式
      • Vocal Removal
        • 音频分离回调
        • 人声和乐器分离
        • 从音频生成 MIDI
      • Music Video Generation
        • MP4生成完成回调
        • 创建音乐视频
      • Sounds Generation
        • 生成声音
      • Speech Generation
        • 生成语音
      • voice
        • Suno Voice 生成回调
        • Suno Voice 验证短句回调
        • Suno Voice生成验证短句接口
        • Suno Voice自建音色生成接口
        • Suno Voice 重新生成验证短句
        • Suno Voice检查是否可用接口
    • Gemini
      • Gemini 3.1 Flash文生语音
      • Gemini 3.8 Flash 文生语音
      • Gemini 3.8 Flash Lite 文生语音
      • Gemini 2.5 Pro文生语音
    • Nemotron 3.5 Transcribe 语音转写
  • Chat Models
    • Codex
      • GPT Codex
    • Grok
      • Grok 4.5
      • Grok 4.7
      • Grok 4.3
      • Grok 4.6
    • GPT
      • Gpt 6 Astra
      • GPT 6.1 Terra
      • GPT 6 Luna
      • GPT 6 Sol
      • GPT 6.1 Sol
      • GPT 5.2
      • GPT 5.4 (response)
      • GPT 5.6 Luna
      • GPT 5.6 Terra
      • GPT 5.6 Sol
      • GPT 5.5 (response)
      • GPT 6.2 Sol
      • GPT 6.2 Astra
    • Claude
      • Claude Code 对接 emix.ai 使用指南
      • Claude Sonnet 5
      • Claude Opus 5
      • Claude Opus 5.5
      • Claude Sonnet 5.5
      • Claude Haiku 5.5
      • Claude Opus 4.7
      • Claude Opus 4.8
      • Claude Fable 5
      • Claude Sonnet 4.5
      • Claude Haiku 4.5
      • Claude Opus 4.5
      • Claude Opus 4.6
      • Claude Sonnet 4.5
      • Claude Sonnet 4.6
    • Gemini
      • Gemini 3.6 Flash
      • Gemini 3.6 Flash (openai)
      • Gemini 3.7 Flash (openai)
      • Gemini 4 Argon
      • Gemini 4 Argon (openai)
      • Gemini 4 Carbon
      • Gemini 4 Carbon (openai)
      • Gemini 4 Neon
      • Gemini 4 Neon (openai)
      • 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.5 Flash
      • Gemini 3.5 Flash (openai)
      • Gemini 3 Flash
      • Gemini 3.7 Flash
      • Gemini 3.8 Flash
      • Gemini 3.8 Flash (openai)
    • Kimi
      • Kimi K3.1 Pro
      • Kimi K3
    • Deepseek
      • DeepSeek V4.1 Flash
  • 获取任务详情
    GET
  1. Market

Webhook 安全校验

为确保回调请求的安全性,强烈建议在生产环境中启用 Webhook HMAC 签名校验,防止伪造或篡改的请求。

算法说明#

Emix 使用 HMAC-SHA256 算法对 Webhook 回调签名,用于确认回调确实来自 Emix、且请求体在传输中没有被改动。
签名生成步骤:
1.
取原始请求体:Emix 发送的 JSON 请求体的原始字节(UTF-8),不做任何解析。
2.
以 Webhook HMAC Key 为密钥计算 HMAC-SHA256 签名:
signature = HMAC-SHA256(rawRequestBody, webhookHmacKey)
3.
Base64 编码:
finalSignature = Base64.encode(signature)
请对收到的原始请求体直接计算签名。不要先把 JSON 解析再重新序列化后签名:空白或字段顺序的变化都会导致签名不一致。

获取 Webhook HMAC Key#

您可以在 Emix 设置页面(Settings → Webhook HMAC Key)生成并查看您的 webhookHmacKey。重新生成会替换旧密钥,之后发出的回调使用新密钥签名。
webhookHmacKey 用于验证回调请求是否来自 Emix 官方服务器。请妥善保管此密钥,切勿泄露或提交到代码仓库。

Webhook Header 说明#

在设置页面生成 webhookHmacKey 后,所有回调请求的 HTTP Header 中都会包含以下字段。未生成密钥时,回调不带签名头。

X-Emix-Signature#

类型: String
必填: 是(已生成 Webhook HMAC Key 时)
描述: 以 webhookHmacKey 为密钥,对原始请求体计算 HMAC-SHA256 并 Base64 编码后的签名。新接入请校验这个头。

X-Kie-Signature#

类型: String
必填: 是(已生成 Webhook HMAC Key 时)
描述: 旧头,值与 X-Emix-Signature 完全相同,为兼容保留,已按它校验的接入方不受影响。

签名生成规则:#

base64(HMAC-SHA256(rawRequestBody, webhookHmacKey))
其中:
rawRequestBody 为您的服务器收到的原始回调 body(UTF-8 字节)
webhookHmacKey 为您在控制台生成的密钥

Webhook 校验流程#

请按照以下步骤验证 Webhook 请求的合法性:
1
读取原始 body 和 Header
在解析 JSON 之前读取原始请求体字节,并从 HTTP Header 中提取 X-Emix-Signature。
2
生成签名
使用本地保存的 webhookHmacKey,对原始请求体计算 HMAC-SHA256,再做 Base64 编码。
3
对比签名
将计算出的签名与 X-Emix-Signature 进行对比。使用常量时间比较算法防止时序攻击。

完整示例代码#

以下是在常用编程语言中实现 Webhook 签名校验的完整示例:
Node.js
Python
PHP
Java

示例 Webhook 请求#

以下是一个带签名的 webhook 请求示例:

注意事项#

请在 10 秒内返回 2xx 状态码。Emix 最多等待 10 秒,回调失败不会重试,错过的结果请用任务详情接口查询。
已按 X-Kie-Signature 校验的,继续可用(值相同);改为校验 X-Emix-Signature 无需其他改动。
密钥泄露时,请在设置页面重新生成并更新您的服务器配置。
Next
开始使用
Built with