Flux Kontext Pro

Black Forest Labs Flux Kontext Pro 文生图与图片编辑模型，支持参考图、1K/2K 分辨率。

BFL · Flux

Black Forest Labs 出品的上下文感知图像生成模型，支持文生图和图片编辑两种模式。

文件上传提示:生成接口不再接收内联 base64 图片数据。请先使用文件上传接口上传图片获取 URL,再把 URL 放进 image_urls 参数。

调用示例

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "一只在京都樱花树下的赛博狐狸,电影质感,Portra 400 胶片",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "response_format": "png"
    }
  }'

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "把背景换成赛博朋克霓虹街道,保留主体",
    "image_urls": ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
    "size": "match_input_image",
    "n": 1,
    "metadata": {
      "response_format": "jpg",
      "safety_tolerance": 3
    }
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="flux-kontext-pro",
    prompt="一只在京都樱花树下的赛博狐狸,电影质感",
    size="16:9",
    n=1,
)

for d in img.data:
    print(d.url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "flux-kontext-pro",
  prompt: "一只在京都樱花树下的赛博狐狸,电影质感",
  size: "16:9",
  n: 1,
});

img.data.forEach((d) => console.log(d.url));

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	固定为 `flux-kontext-pro`
prompt	string	是	—	英文 / 中文均可
size	string	否	见说明	画面比例:有参考图时默认 `match_input_image`,无参考图时默认 `16:9`。支持:`match_input_image` / `1:1` / `4:3` / `3:4` / `16:9` / `9:16` / `3:2` / `2:3` / `21:9` / `9:21`
n	int	否	1	一次出图数量,1–4
image_urls	string[]	否	—	参考图 URL 数组,最多 1 张。有参考图为图片编辑模式,无参考图为文生图模式
metadata	object	否	—	元参数,详见下方说明

metadata 参数

参数	类型	必填	默认值	说明
metadata.response_format	string	否	png	输出图像格式:`png` / `jpg`
metadata.safety_tolerance	int	否	2	安全过滤容忍度,取值范围 `0`–`6`,数值越高容忍度越高
metadata.prompt_upsampling	bool	否	false	是否启用提示词增强。`true`:自动优化/扩展提示词;`false`:使用原始提示词

图生图说明

参考图建议先走文件上传接口获得 URL
当前不支持直接上传二进制图片文件;请传 URL
size 为 match_input_image 时自动匹配输入图片比例(仅图片编辑时可用)

响应示例

创建成功后立即返回任务状态,后续通过异步任务查询结果:

{
  "id": "img_01HX...",
  "object": "generation.task",
  "status": "queued",
  "progress": 0,
  "model": "flux-kontext-pro",
  "created_at": 1718000000
}

计费

按 图片张数 扣费,单价 $0.032 / 张。完整实时价目以模型列表页为准,本页价格为 2026-07 快照。失败请求(含上游 502)全额退款,不计费。

错误码

code	type	含义	HTTP
400101	`invalid_param`	参数错误 (尺寸不支持等)	400
400401	`insufficient_balance`	余额不足	400
401104	`api_key_invalid`	API Key 无效	401
429101	`rate_limit_exceeded`	RPM 超限	429
429302	`daily_quota_exceeded`	每日调用配额耗尽	429
502201	`upstream_unavailable`	BFL 服务暂不可用	502
502203	`no_available_account`	暂无可用账号	502

完整列表见错误码。

注意事项

CDN 图片 URL 24 小时后失效,需长期保存请下载到自有存储。
失败请求 (含上游 502) 全额返还本次扣费,不计费。

本页目录