Flux Kontext API 快速开始

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

概述

Flux Kontext API 让您能够使用先进的AI模型生成和编辑高质量图像。无论您是在构建应用、自动化工作流程还是创建内容，我们的API都为AI图像生成和编辑提供了简单可靠的访问方式。

文本转图像生成

从详细的文本描述或图片创建令人惊叹的AI图像

任务详情

实时状态跟踪和webhook回调通知

生成的图像存储 14天 并在此期间后自动过期。

身份验证

所有API请求都需要通过Bearer Token进行身份验证。

获取您的API密钥

访问 API密钥管理页面获取您的API密钥。

添加到请求头

在所有请求中包含您的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）

最佳实践

性能优化

使用回调：设置webhook回调而不是轮询以获得更好的性能

模型选择：对标准任务使用 flux-kontext-pro，对复杂场景使用 flux-kontext-max

提示词工程：使用详细、具体的提示词以获得更好的结果

图像预处理：确保输入图像可访问且经过优化

下载管理：及时下载图像，因为它们14天后会过期

翻译设置：如果您的提示词已经是英文，请设置 enableTranslation: false

重要限制

语言支持：提示词仅支持英文（使用 enableTranslation: true 进行自动翻译）

图像存储：生成的图像14天后过期

原始图像URL：生成后仅10分钟有效

安全容忍度：生成模式（0-6），编辑模式（0-2）

输入图像：必须是公开可访问的URL

支持的参数

核心参数

参数	类型	描述	默认值
`prompt`	string	必需。生成/编辑的文本描述	-
`aspectRatio`	string	输出图像宽高比	`16:9`
`model`	string	`flux-kontext-pro` 或 `flux-kontext-max`	`flux-kontext-pro`
`outputFormat`	string	`jpeg` 或 `png`	`jpeg`

可选参数

参数	类型	描述	默认值
`inputImage`	string	图像编辑模式的URL	-
`enableTranslation`	boolean	自动翻译非英文提示词	`true`
`promptUpsampling`	boolean	AI提示词增强	`false`
`safetyTolerance`	integer	内容审核级别	`2`
`callBackUrl`	string	Webhook通知URL	-
`uploadCn`	boolean	使用中国服务器上传	`false`
`watermark`	string	水印标识符	-

下一步

生成或编辑图像

了解所有生成和编辑参数及高级选项

跟踪进度

监控任务状态并检索详细的生成信息

Webhook回调

设置任务完成的自动通知

支持

需要帮助吗？我们的技术支持团队随时为您提供帮助。

邮箱: support@kie.ai

文档: docs.kie.ai

API状态: 查看我们的状态页面了解实时API健康状况

Flux Kontext API 快速开始

概述#

身份验证#

基本用法#

1. 从文本生成图像#

2. 编辑现有图像#

3. 检查生成状态#

完整工作流程示例#

高级功能#

模型选择#

宽高比选项#

提示词增强#

安全容忍度控制#

使用回调#

错误处理#

最佳实践#

支持的参数#

核心参数#

可选参数#

下一步#

支持#

概述

身份验证

基本用法

1. 从文本生成图像

2. 编辑现有图像

3. 检查生成状态

完整工作流程示例

高级功能

模型选择

宽高比选项

提示词增强

安全容忍度控制

使用回调

错误处理

最佳实践

支持的参数

核心参数

可选参数

下一步

支持