认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key：
访问 API Key 管理页面 获取你的 API Key
使用方法：
添加到请求头：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
可选值: flux_kontext_pro
prompt string 必填
所需图像的文本描述
input_image string
作为参考使用的 Base64 编码图像或图像的 URL. 支持高达 20MB
input_image_2 string
作为参考使用的 Base64 编码图像或图像的 URL. 支持高达 20MB
input_image_3 string
作为参考使用的 Base64 编码图像或图像的 URL. 支持高达 20MB
input_image_4 string
作为参考使用的 Base64 编码图像或图像的 URL. 支持高达 20MB
seed integer
用于可重复性. 如果为 null 或省略, 则使用随机种子. 接受任何整数
aspect_ratio string
图像的长宽比, 介于 21:9 和 9:21 之间
output_format string
输出格式
可选值: jpeg、png
默认值: jpeg
prompt_upsampling boolean
是否对提示进行上采样. 如果激活, 会自动修改提示词以实现更具创意的生成
默认值: false
safety_tolerance integer
输入和输出调节的容忍水平. 0 表示最严格, 6 表示最不严格
范围: 1 - 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 字段中提供