统一认证，接入所有提供方
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-max",
"prompt": "编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。"
}'import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-max",
prompt: "编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\FluxKontext\FluxKontextClient;
$client = new FluxKontextClient();
$result = $client->textToImage->run([
'model' => 'flux-kontext-max',
'prompt' => '编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。',
]);require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-max",
prompt: "编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。"
)npx skills add runapi-ai/flux-kontext -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor概览
关于 Flux Kontext
Flux Kontext 是 Black Forest Labs 的上下文图像编辑模型，可在保留风格、角色特征和场景构图的同时进行精准编辑，擅长风格迁移和多次生成的视觉一致性保持。
提供方
Black Forest Labs
模态
Image
对比全部 API 变体
定价
Flux Kontext 定价
| Endpoint | 分辨率 | 时长 | 价格 | |
|---|---|---|---|---|
| text_to_image | — | — | $0.17 / image |
当前价格适用于 flux-kontext-max。其他变体保留各自的 endpoint 定价。
Agent 集成
通过 Agent 运行 Flux Kontext
工作流程
开始使用 Flux Kontext
-
选择模型
根据输出类型、质量要求和延迟目标选择模型与变体。
-
配置
设置 RunAPI key，并在代码工作区安装对应 model skill。
-
调用
按 skill 里的说明，把模型能力接入到你的应用里。
-
接收
按 task ID 轮询、在支持时使用流式，或处理 webhook 回调。
为什么用 RunAPI 调用 Flux Kontext API
统一的定价与账单
USD 按次定价，按月结算。失败的生成不计费。
Schema 优先的 SDK
Typed schema 和接入说明已打包进 model skill，让实现从正确契约开始。
Flux Kontext 常见问题
什么是上下文编辑？
Flux Kontext 在编辑图像特定区域的同时，保留未修改区域的光照、透视和风格。
Pro 和 Max 有什么区别？
Pro 是适合大多数编辑任务的标准版本。Max 提供更高保真度，适合复杂的多元素编辑。
支持哪些输入格式？
支持 JPEG、PNG 和 WebP。输入图像保持在 10 MB 以内以获得最佳效果。
跨编辑任务可以保持角色一致性吗？
可以——Kontext 专为编辑背景、服装或场景元素时保持角色一致性而设计。
生成速度有多快？
通常每张图像需要 3–5 秒，具体取决于复杂度和所用变体。
应该从哪个变体开始？
选满足质量要求的最便宜变体。多数团队从 fast 起步，生产时升级到 pro。
相似模型