flux-kontext-pro API
Black Forest Labs / Flux Kontext
通过 RunAPI 使用 Flux Kontext 系列的 flux-kontext-pro。按次计费，无需订阅，失败的生成不计费。
运行中
·
image
·
可商用
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。"
}'import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-pro",
prompt: "编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\FluxKontext\FluxKontextClient;
$client = new FluxKontextClient();
$result = $client->textToImage->run([
'model' => 'flux-kontext-pro',
'prompt' => '编辑这张产品照片：将背景换成热带海滩，保持产品完全不变。',
]);require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-pro",
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-pro 在 Flux Kontext 家族中处于质量与成本的最佳平衡点。
- USD 按次定价
- 失败不计费
- 模型支持时流式
- Schema 校验后的工具调用
定价
定价
失败的生成不计费
Text to image
$0.05
/ image
规格
技术细节
| 模型 ID | flux-kontext-pro |
| 提供方 | Black Forest Labs |
| 模态 | image |
| 任务类型 | asynchronous |
| 计费单位 | call |
| API 端点 | /api/v1/flux_kontext/text_to_image |
| 商用许可 | 允许商用 |
| 收录状态 | 运行中 |
技能
Model skill — flux-kontext-pro
安装一次 skill，开发时使用本页的变体 ID。
# Install the model skill for app development workflows
npx skills add runapi-ai/flux-kontext -gOr use this setup request in your coding tool:
Install the Flux Kontext skill for this app: 1. Add runapi-ai/flux-kontext with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
工作流程
用 model skill 使用 flux-kontext-pro
01
安装
安装该模型线对应的 model skill。
02
配置
把 model 字段设置为本页展示的完整模型 ID。
03
调用
按 skill 说明把提示词、输入文件和回调处理接入应用。
04
接收
从 RunAPI 读取任务响应、webhook 回调或缓存输出 URL。
差异
flux-kontext-pro 与其它变体的差异
VS FLUX-KONTEXT-MAX
上下文编辑的速度与质量均衡
4K 输出，更强文字渲染，高级上下文编辑
应用场景
最适合的场景
产品摄影
为缺少棚拍照片的电商商品自动生成场景化产品图。
游戏与概念设计
快速概念化环境和角色，再进入最终美术制作。
编辑配图
为博客文章和专栏批量生成独特封面图和插图。
常见问题
flux-kontext-pro 常见问题
模型 ID 跨版本稳定吗？
RunAPI 保持模型 ID 稳定，并在不改变请求形态的前提下处理兼容版本刷新。
该变体的限流？
Key 级限流随使用层级伸缩。当前限制见定价页。
能切到其它变体吗？
可以——变体只是参数，改 model 字段即可。
支持流式吗？
模型支持流式时，RunAPI 端到端流式。
质量问题在哪里报？
在公共 GitHub 仓库提 issue 或邮件联系 support。
立即开始