认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取你的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY参数
model string 必填
要使用的模型 ID
值: flux_kontext_max
prompt string 必填
文本提示词, 描述要生成或编辑图像内容
input_image string
第 1 张输入图像, 支持 Base64 编码或 URL 格式
input_image_2 string
第 2 张输入图像, 支持 Base64 编码或 URL 格式
input_image_3 string
第 3 张输入图像, 支持 Base64 编码或 URL 格式
input_image_4 string
第 4 张输入图像, 支持 Base64 编码或 URL 格式
seed integer
随机种子, 用于可重现生成结果
aspect_ratio string
图像宽高比, 格式如 16:9
范围: 21:9 - 9:21
steps integer
推理步数
范围: 1 - 50
guidance_scale number
引导比例
范围: 1 - 10
negative_prompt string
负面提示词, 描述不希望出现内容
output_format string
输出格式
可选值: jpeg、png
默认值: jpeg
prompt_upsampling boolean
是否启用提示词自动增强. 如果激活, 会自动修改提示词以实现更具创意生成
默认值: False
safety_tolerance integer
输入和输出调节容忍水平. 0 表示最严格, 6 表示最不严格
范围: 0 - 6
默认值: 2
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅当状态为 failed 时存在
code
string错误码
message
string详细错误消息
output array
生成结果. 仅当状态为 completed 时存在
content
array生成内容列表
type
string资源类型. 值：
imageurl
string生成内容的 URL
usage object
使用统计信息. 仅当状态为 completed 时存在
cost
string总成本（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
当状态为 failed 时，错误信息会在 error 字段中提供.