Flux Kontext Pro 图像生成

model = flux-kontext-pro·¥0.18/张

异步处理模式：提交后立即返回 task_id，再轮询任务接口
统一生图接口 POST /api/v1/images/generations
通过 size 支持 16 种尺寸/比例
参考图最多 14 张（URL / base64）
渠道：标准渠道 · 售价 ¥0.18/张 · 失败自动退款

POST /api/v1/images/generations

模型页试一试 →

标准渠道

本模型为标准（经济）路由。同族若存在「官方渠道」条目，可在左侧目录展开切换。

模型 ID

请求体 model 必须为 flux-kontext-pro。

简介

Flux 上下文编辑

同族渠道

同一模型族下的官方 / 标准渠道，参数与单价可能不同，请按业务选择。

POST Flux Kontext Max 图像生成[标准渠道]

Authorizations

需要 Bearer Token。在 API Key 管理创建后，请求头加入：

Authorization: Bearer cr_你的API_Key

Base URL：https://xiaoguai123.xyz

Body

模型名称

固定填写 flux-kontext-pro

图像生成的文本描述

支持中英文，建议详细描述
可能触发内容安全策略，违规会直接报错

尺寸 / 画面比例

按枚举或像素串传入
未知值会被拒绝
可选：auto / 1:1 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 16:9 / 9:16 / 2:1 / 1:2 / 3:1 / 1:3 / 21:9 / 9:21
默认："1:1"

size	类型
auto	自动
1:1	正方
3:2	横图
2:3	竖图
4:3	横图
3:4	竖图
5:4	横图
4:5	竖图
16:9	横图
9:16	竖图
2:1	横图
1:2	竖图
3:1	横图
1:3	竖图
21:9	横图
9:21	竖图

使用场景示例

文生图（最简）

{
  "model": "flux-kontext-pro",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格"
}

带默认参数的完整示例

{
  "model": "flux-kontext-pro",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
  "size": "1:1",
  "n": 1
}

图生图 / 编辑

{
  "model": "flux-kontext-pro",
  "prompt": "把这张照片变成插画风格",
  "image_urls": [
    "https://example.com/ref.jpg"
  ],
  "size": "1:1"
}

Response

提交成功时返回任务数组：

status：如 submitted（已提交）
task_id：任务唯一标识，用于后续查询

查询任务结果

GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
Authorization: Bearer cr_你的API_Key

• 提交：POST https://xiaoguai123.xyz/api/v1/images/generations

• 查询：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

• status=completed 时读取 result.images / result.videos；failed 已自动退款

详见任务查询接口。

状态	含义
pending / submitted	已提交或排队
processing	上游处理中
completed	成功，result 可用
failed	失败，已自动退款

REQUEST

curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
  -H "Authorization: Bearer cr_你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "flux-kontext-pro", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "size": "1:1" }'

RESPONSE

成功提交

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "xg_01hxyz..."
    }
  ]
}