灵活的参数配置
可配置文档中列出的 8 个参数,包括 aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt。
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": "编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。"
}'
import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-pro",
prompt: "编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。",
});
import os
import requests
response = requests.post(
"https://runapi.ai/api/v1/flux_kontext/text_to_image",
headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"},
json={"model":"flux-kontext-pro","prompt":"编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。"}
)
response.raise_for_status()
<?php
$client = curl_init("https://runapi.ai/api/v1/flux_kontext/text_to_image");
curl_setopt_array($client, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("RUNAPI_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'flux-kontext-pro',
'prompt' => '编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。',
])
]);
$response = curl_exec($client);
RunApi client = new RunApi(System.getenv("RUNAPI_API_KEY"));
Task task = client.textToImage().run({"model":"flux-kontext-pro","prompt":"编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。"});
task.waitForResult();
require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-pro",
prompt: "编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。"
)
client := runapi.NewClient(os.Getenv("RUNAPI_API_KEY"))
task, err := client.textToImage.Run({"model":"flux-kontext-pro","prompt":"编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。"})
if err != nil { log.Fatal(err) }
task.Wait()
$ runapi generate \
--model flux-kontext-pro \
--endpoint text_to_image \
--wait
2 个版本可用
选择任意模型,几秒内开始生成。
选择任意模型,几秒内开始生成。
| 提供商 | Black Forest Labs |
| 模型 ID | flux-kontext-pro |
| 模态 | Image |
| 任务类型 | Asynchronous |
| API 端点 | /api/v1/flux_kontext/text_to_image |
| 计费单位 | call |
| 输入参数 | 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 |
| 目录状态 | 运行中 |
免费注册后,在控制台创建用于 flux-kontext-pro 的 API 密钥。
向 /api/v1/flux_kontext/text_to_image 发送 POST 请求,并传入 flux-kontext-pro 模型 ID 和参数。
轮询任务或按照回调获取已完成的 flux-kontext-pro 结果。
可配置文档中列出的 8 个参数,包括 aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt。
提供 1 个公开 endpoint:text_to_image。
异步任务支持回调 URL,任务完成时发送通知。
按 call 计量,无需订阅。
promptImage description (English only).
watermarkWatermark identifier.
aspect_ratioOutput aspect ratio. Default: 16:9. (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
callback_urlWebhook URL for async notifications.
output_formatOutput format. Default: jpeg. (jpeg, png)
safety_toleranceContent safety threshold. 0-6 for generation, 0-2 for editing. Default: 2.
source_image_urlSource image URL for editing mode.
enable_translationAuto-translate non-English prompts. Default: true.
enable_prompt_expansionExpand the prompt with more detail. Default: false.
为缺少棚拍照片的电商商品自动生成场景化产品图。
快速概念化环境和角色,再进入最终美术制作。
为博客文章和专栏批量生成独特封面图和插图。
传入 quickstart 中显示的模型 ID。
Key 级限流随使用层级伸缩。当前限制见定价页。
可以——变体只是参数,改 model 字段即可。
模型支持流式时,RunAPI 端到端流式。
在公共 GitHub 仓库提 issue 或邮件联系 support。