认证
authorization string 必填
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取你的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
可选值: flux_pro_11
prompt string 必填
期望图像的文本描述
image_prompt string
图片 Base64, 用于图像引导生成
width integer
图片宽度, 必须是 32 的倍数
范围: 256 - 1440
默认值: 1024
height integer
图片高度, 必须是 32 的倍数
范围: 256 - 1440
默认值: 1024
prompt_upsampling boolean
是否对提示进行上采样. 如果激活, 会自动修改提示词以实现更具创意的生成
默认值: false
seed integer
随机种子, 用于结果复现, 接受任何整数
safety_tolerance integer
内容审核级别. 值范围从 0(最严格)到 6(更宽松)
范围: 0 - 6
默认值: 2
output_format string
输出格式
可选值: jpeg、png
默认值: jpeg
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 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 字段中提供