FLUX.1 Kontext API
FLUX.1 Kontext 是支持图片编辑和文生图的上下文感知模型系列，提供 Pro 与 Max 两个版本、可预测的按张计费和异步任务处理。
上下文感知编辑文生图固定按张计费
服务亮点
- 官方折扣
- 按量计费
- 高速低延
Input
2
输出
Image link valid for 72 hours
FLUX.1 Kontext API 价格
透明定价，无隐藏费用。按量付费，用多少付多少。
| 型号 | 黄金价当前价格 | 铂金价 | 钻石价 | 官方价 | 为你节省 |
|---|---|---|---|---|---|
flux-kontext-pro | 0.32Credits(~$0.032)/张 | 0.304Credits(~$0.0304)/张 | 0.288Credits(~$0.0288)/张 | 0.4Credits(~$0.04)/张 | 20% |
flux-kontext-max | 0.64Credits(~$0.064)/张 | 0.608Credits(~$0.0608)/张 | 0.576Credits(~$0.0576)/张 | 0.8Credits(~$0.08)/张 | 20% |
* 实际费用以最终输出为准。
FLUX.1 Kontext API 示例：文生图与图片编辑
一次 POST 请求即可调用 flux-kontext-pro。生成为异步任务：先提交任务，再轮询任务接口获取图片链接。
- 1
FLUX.1 Kontext API 请求鉴权
把 APIMart Key 保存到环境变量 APIMART_API_KEY，每个请求都带上 Authorization: Bearer <key>。
- 2
提交 FLUX.1 Kontext 任务
向 POST /v1/images/generations 提交 model flux-kontext-pro、提示词和 size。编辑时传 image_urls，最多 4 张参考图。示例里的 example.com 地址只是占位，请换成你自己可公开访问的图片 URL 或 Base64。任务 ID 在 data[0].task_id。
- 3
获取 FLUX.1 Kontext 结果
轮询 GET /v1/tasks/{task_id}，状态为 completed 后从 data.result.images[0].url[0] 读取图片链接。结果保留 72 小时，请及时下载需要保存的图片。
全部参数、输出尺寸与返回字段见 FLUX.1 Kontext API 文档。
POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "温馨的阅读角，绿色扶手椅，暖色台灯，窗外下着雨",
"size": "4:3",
"output_format": "png"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "flux-kontext-pro",
"prompt": "温馨的阅读角，绿色扶手椅，暖色台灯，窗外下着雨",
"size": "4:3",
"output_format": "png"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "把夹克换成深红色皮夹克，人物面部、姿势和背景保持不变",
"size": "auto",
"output_format": "png",
"image_urls": [
"https://example.com/portrait.jpg"
]
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"FLUX.1 Kontext API 参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | 默认值: flux-kontext-pro | flux-kontext-pro 或 flux-kontext-max。 |
prompt | string | 是 | 默认值: — | 描述要生成的图片，或要对参考图做的修改。 |
image_urls | string[] | 否 | 默认值: — | 最多 4 张参考图，公开 URL 或 Base64。文生图时不传。 |
size | string | 否 | 默认值: 1:1 | 1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、9:21 或 auto。输出约 1 MP：传 width 或 height 会导致任务失败，resolution 不生效。 |
output_format | string | 否 | 默认值: png | png、jpeg 或 webp。 |
seed | integer | 否 | 默认值: — | 使用相同 seed 和输入有助于复现结果；不传则随机。 |
prompt_upsampling | boolean | 否 | 默认值: false | 生成前由模型扩写并改写提示词。 |
safety_tolerance | integer | 否 | 默认值: 2 | 0（最严格）到 6。 |
nsfw_check | boolean | 否 | 默认值: false | 提交前用 omni-moderation-latest 审核提示词和输入图片。 |
APIMart 上的 FLUX API 模型对比
一个 APIMart API Key 即可调用下表所有 FLUX 模型。图片模型按张计费，FLUX 3 Video 按视频秒数计费。
| 模型 | 适合场景 | 输出 |
|---|---|---|
| FLUX 3 Image API | 图片方向的 FLUX 3 API：文生图与编辑，最多 10 张参考图，支持搜索增强，最高 4K 输出 | 768sq 至 4K（约 16 MP） |
| FLUX 3 Image Klein API | 成本更低的 FLUX 3 图片，可设 seed、1–16 步，输出 PNG 或 JPEG | 768sq 至 4K（约 16 MP） |
| FLUX 3 Video API | 文生视频、1–10 张关键帧、视频续写与草稿，自带同步音频 | HD 或 FHD，5–20 秒 |
| FLUX.2 API | 在一个页面里比较 FLUX.2 Pro、Max 与 Flex | 1–4 MP |
| FLUX.2 Pro API | 兼顾质量与成本的生产级图片，最多 8 张参考图 | 1–4 MP |
| FLUX.2 Max API | FLUX.2 系列最高画质，最多 8 张参考图 | 1–4 MP |
| FLUX.2 Flex API | 可调 steps 与 guidance，适合文字排版和版式设计 | 1–4 MP |
| FLUX.1 Kontext API当前页面 | 在一个页面里比较 FLUX.1 Kontext Pro 与 Max | 约 1 MP |
| FLUX.1 Kontext Pro API | 上下文感知编辑，每张固定价格，最多 4 张参考图 | 约 1 MP |
| FLUX.1 Kontext Max API | 画质更高、更贴合提示词的 Kontext 编辑 | 约 1 MP |
