KIE.AI
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Market
File Upload APICommon API
Market
File Upload APICommon API
  1. Flux Kontext 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 快速开始
      • 图像生成或编辑回调
      • 生成或编辑图像
        POST
      • 获取图像详情
        GET
    • 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视频
    • 扩展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. 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@kie.ai
文档: docs.kie.ai
API状态: 查看我们的状态页面了解实时API健康状况
准备创建令人惊叹的AI图像了吗?从上面的示例开始,探索完整的API功能!
Previous
获取直接下载URL
Next
图像生成或编辑回调
Built with