Black Forest Labs

Flux Kontext pro

图像

上下文编辑的速度与质量均衡

起价 $0.03 / 次调用 Flux Kontext pro API 参考 →
模型健康状态 数据不足
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-pro",
  "prompt": "编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。"
}'
https://runapi.ai 1 endpoint

2 个版本可用

模型体验

体验 Flux Kontext pro

选择任意模型,几秒内开始生成。

预计: $0.03 / 张图片

登录后即可使用 RunAPI 生成。

登录后生成

登录后即可使用可用语言模型开始生成。

规格

技术细节

提供商 Black Forest Labs
模型 ID flux-kontext-pro
模态 图像
任务类型 Asynchronous
API 端点 /api/v1/flux_kontext/text_to_image
计费单位 次调用
输入参数 aspect_ratio, callback_url, enable_prompt_expansion, enable_translation, model, output_format, prompt, safety_tolerance, source_image_url, watermark
宽高比 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
输出格式 jpeg, png
目录状态 运行中
工作原理

3 步使用此模型

  1. 获取 API 密钥

    免费注册后,在控制台创建用于 flux-kontext-pro 的 API 密钥。

  2. 发送请求

    向 /api/v1/flux_kontext/text_to_image 发送 POST 请求,并传入 flux-kontext-pro 模型 ID 和参数。

  3. 获取结果

    轮询任务或按照回调获取已完成的 flux-kontext-pro 结果。

该模型的核心能力

灵活的参数配置

可配置文档中列出的 8 个参数,包括 aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt。

Endpoint 覆盖

提供 1 个公开 endpoint:text_to_image。

Webhook 推送

异步任务支持回调 URL,任务完成时发送通知。

按量计费

按 次调用 计量,无需订阅。

Flux Kontext pro 定价

端点
分辨率
时长
价格
text_to_image
暂不可用
次调用
$0.03 / 张图片
API 参考

端点规格

端点
POST /api/v1/flux_kontext/text_to_image
模型 ID
flux-kontext-pro
任务类型
text_to_image
最大时长
暂无数据
分辨率
暂无数据
宽高比
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
输出格式
JPEG, PNG
平均生成时间
暂无数据

请求参数

prompt

必填 string

Image description (English only).

watermark

可选 string

Watermark identifier.

aspect_ratio

可选 string

Output aspect ratio. Default: 16:9. (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)

callback_url

可选 string

Webhook URL for async notifications.

output_format

可选 string

Output format. Default: jpeg. (jpeg, png)

safety_tolerance

可选 integer

Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2.

source_image_url

可选 string

Source image URL for editing mode.

enable_translation

可选 boolean

Auto-translate non-English prompts. Default: true.

enable_prompt_expansion

可选 boolean

Expand the prompt with more detail. Default: false.

应用场景

产品摄影

为缺少棚拍照片的电商商品自动生成场景化产品图。

游戏与概念设计

快速概念化环境和角色,再进入最终美术制作。

编辑配图

为博客文章和专栏批量生成独特封面图和插图。

常见问题

Flux Kontext pro 常见问题

如何选择 flux-kontext-pro?

传入 quickstart 中显示的模型 ID。

该变体的限流?

Key 级限流随使用层级伸缩。当前限制见定价页。

能切到其它变体吗?

可以——变体只是参数,改 model 字段即可。

支持流式吗?

模型支持流式时,RunAPI 端到端流式。

质量问题在哪里报?

在公共 GitHub 仓库提 issue 或邮件联系 support。

需要单独的提供方账户吗?

不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型,无需底层提供方账户。

需要团队接入支持?

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们