欢迎使用 Flux Kontext API
Flux Kontext API 让您能够使用最先进的AI模型生成和编辑高质量图像。无论您是在构建应用、自动化工作流程还是创建内容,我们的API都为AI图像生成和编辑提供了简单可靠的访问方式。生成的图像存储 14天 并在此期间后自动过期。
身份验证
所有API请求都需要通过Bearer Token进行身份验证。1
获取您的API密钥
访问 API密钥管理页面 获取您的API密钥。
2
添加到请求头
在所有请求中包含您的API密钥:
请妥善保管您的API密钥,切勿公开分享。如果怀疑泄露,请立即在管理页面重置。
基本用法
1. 从文本生成图像
首先创建您的第一个文本转图像生成任务:2. 编辑现有图像
使用文本提示修改现有图像:3. 检查生成状态
使用返回的taskId
监控进度:
0
: 生成中 - 任务正在处理1
: 成功 - 任务成功完成2
: 创建任务失败 - 创建任务失败3
: 生成失败 - 任务创建成功但生成失败
完整工作流程示例
以下是一个生成图像并等待完成的完整示例:高级功能
模型选择
根据您的需求选择合适的模型:宽高比选项
支持各种图像格式:提示词增强
让AI优化您的提示词:安全容忍度控制
调整内容审核级别:使用回调
设置webhook回调以获得自动通知:了解更多关于回调
设置webhook回调以在图像准备就绪时接收自动通知。
错误处理
常见错误场景及处理方法:内容政策违反(代码 400)
内容政策违反(代码 400)
安全容忍度超出范围(代码 500)
安全容忍度超出范围(代码 500)
速率限制(代码 429)
速率限制(代码 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 | 水印标识符 | - |
下一步
支持
需要帮助吗?我们的技术支持团队随时为您提供帮助。- 邮箱: support@fluxapi.ai
- 文档: docs.fluxapi.ai
- API状态: 查看我们的状态页面了解实时API健康状况