docs.emix.ai
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Market
File Upload API
Market
File Upload API
  1. Flux Kontext API
  • 开始使用
  • 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 图片编辑
      • Seedream 5.0 Pro 图层分离
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
    • Google
      • Google Imagen4 Fast
      • Google Imagen4 Ultra
      • Google Imagen4
      • Google Nano Banana
      • Nano Banana Pro 图生图
      • 使用 nano-banana-2 生成内容
      • Nano Banana 2 Lite
    • 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 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 快速开始
      • 图像生成或编辑回调
      • 生成或编辑图像
        POST
      • 获取图像详情
        GET
  • Video Models
    • Omnihuman 1.5
      • 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 - 图转视频
      • 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
    • 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-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 生视频
      • Gemini Omni Audio 生语音
      • Gemini Omni Character 生角色
    • Volcengine
      • Volcengine 视频对口型
    • PixVerse
      • PixVerse V6 文生视频
      • PixVerse V6 图生视频
      • PixVerse V6 首尾帧/转场
      • PixVerse V6 视频扩展
      • PixVerse V6 Reference-to-video/参考图生成
    • MiniMax-H3
      • MiniMax H3 文生视频
      • MiniMax H3 图生视频
      • MiniMax H3 参考生视频
  • 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
        • 生成声音
      • voice
        • Suno Voice 生成回调
        • Suno Voice 验证短句回调
        • Suno Voice生成验证短句接口
        • Suno Voice自建音色生成接口
        • Suno Voice 重新生成验证短句
        • Suno Voice检查是否可用接口
    • Gemini
      • Gemini 3.1 Flash文生语音
      • Gemini 2.5 Pro文生语音
  • Chat Models
    • Codex
      • GPT Codex
    • Grok
      • Grok 4.5
      • Grok 4.3
      • Grok 4.6
    • GPT
      • GPT 5.2
      • GPT 5.4 (response)
      • GPT 5.6 Luna
      • GPT 5.6 Terra
      • GPT 5.6 Sol
      • GPT 5.5 (response)
    • Claude
      • Claude Code 对接 emix.ai 使用指南
      • Claude Sonnet 5
      • Claude Opus 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 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)
  • 获取任务详情
    GET
  1. Flux Kontext API

Flux Kontext API 快速开始

欢迎使用 Flux Kontext API!本指南将帮助您在几分钟内开始使用最先进的AI图像生成和编辑功能。

概述#

Flux Kontext API 让您能够使用先进的AI模型生成和编辑高质量图像。无论您是在构建应用、自动化工作流程还是创建内容,我们的API都为AI图像生成和编辑提供了简单可靠的访问方式。
文本转图像生成
从详细的文本描述或图片创建令人惊叹的AI图像
任务详情
实时状态跟踪和webhook回调通知
生成的图像存储 14天 并在此期间后自动过期。

身份验证#

所有API请求都需要通过Bearer Token进行身份验证。
1.
获取您的API密钥
访问 API密钥管理页面 获取您的API密钥。
2.
添加到请求头
在所有请求中包含您的API密钥:
请妥善保管您的API密钥,切勿公开分享。如果怀疑泄露,请立即在管理页面重置。

基本用法#

1. 从文本生成图像#

首先创建您的第一个文本转图像生成任务:
Node.js
Python
cURL
响应:
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_flux_abc123"
  }
}

2. 编辑现有图像#

使用文本提示修改现有图像:
Node.js
Python
cURL

3. 检查生成状态#

使用返回的 taskId 监控进度:
Node.js
Python
cURL
状态值:
0: 生成中 - 任务正在处理
1: 成功 - 任务成功完成
2: 创建任务失败 - 创建任务失败
3: 生成失败 - 任务创建成功但生成失败

完整工作流程示例#

以下是一个生成图像并等待完成的完整示例:
JavaScript
Python

高级功能#

模型选择#

根据您的需求选择合适的模型:

宽高比选项#

支持各种图像格式:

提示词增强#

让AI优化您的提示词:

安全容忍度控制#

调整内容审核级别:

使用回调#

设置webhook回调以获得自动通知:
了解更多关于回调
设置webhook回调以在图像准备就绪时接收自动通知。

错误处理#

常见错误场景及处理方法:
内容政策违反(代码 400)
安全容忍度超出范围(代码 500)
速率限制(代码 429)

最佳实践#

性能优化
1.
使用回调:设置webhook回调而不是轮询以获得更好的性能
2.
模型选择:对标准任务使用 flux-kontext-pro,对复杂场景使用 flux-kontext-max
3.
提示词工程:使用详细、具体的提示词以获得更好的结果
4.
图像预处理:确保输入图像可访问且经过优化
5.
下载管理:及时下载图像,因为它们14天后会过期
6.
翻译设置:如果您的提示词已经是英文,请设置 enableTranslation: false
重要限制
语言支持:提示词仅支持英文(使用 enableTranslation: true 进行自动翻译)
图像存储:生成的图像14天后过期
原始图像URL:生成后仅10分钟有效
安全容忍度:生成模式(0-6),编辑模式(0-2)
输入图像:必须是公开可访问的URL

支持的参数#

核心参数#

参数类型描述默认值
promptstring必需。生成/编辑的文本描述-
aspectRatiostring输出图像宽高比16:9
modelstringflux-kontext-pro 或 flux-kontext-maxflux-kontext-pro
outputFormatstringjpeg 或 pngjpeg

可选参数#

参数类型描述默认值
inputImagestring图像编辑模式的URL-
enableTranslationboolean自动翻译非英文提示词true
promptUpsamplingbooleanAI提示词增强false
safetyToleranceinteger内容审核级别2
callBackUrlstringWebhook通知URL-
uploadCnboolean使用中国服务器上传false
watermarkstring水印标识符-

下一步#

生成或编辑图像
了解所有生成和编辑参数及高级选项
跟踪进度
监控任务状态并检索详细的生成信息
Webhook回调
设置任务完成的自动通知

支持#

需要帮助吗?我们的技术支持团队随时为您提供帮助。
邮箱: support@emix.ai
文档: docs.emix.ai
API状态: 查看我们的状态页面了解实时API健康状况
准备创建令人惊叹的AI图像了吗?从上面的示例开始,探索完整的API功能!
Previous
获取直接下载URL
Next
图像生成或编辑回调
Built with