Flux-1-Kontext 文档

Flux-1-Kontext 是一个专为文本到图像生成和高级图像编辑而设计的模型。本指南专注于其图像编辑功能。与其他模型不同，您无需微调或创建复杂的工作流程即可实现这一目标 - Flux-1-Kontext 开箱即用。

Kontext 的图像编辑功能通过 /flux-kontext-pro 端点提供以下关键功能：

• 简单编辑：更改图像的特定部分，同时保持其余部分不变
• 智能更改：进行看起来自然且与图像其余部分相协调的编辑
• 图像中的文本：在图像中添加或修改文本

快速开始

基本对象修改

Flux-1-Kontext 非常擅长直接的对象修改，例如，如果我们想改变物体的颜色，我们可以通过提示来实现。

例如：Change the car color to red

迭代编辑

Flux-1-Kontext 在角色一致性方面表现出色，即使在多次编辑后也是如此。从参考图片开始，我们可以看到角色在整个序列中保持一致。

文本编辑

Flux-1-Kontext 可以直接编辑图像中出现的文本，使更新标志、海报、标签等变得容易，而无需重新创建整个图像。

编辑文本最有效的方法是使用引号包围您想要更改的特定文本：

提示结构：Replace '[original text]' with '[new text]'

API 使用

要使用 Kontext 进行图像编辑，您需要向 /flux-kontext-pro 端点发送请求。这需要同时提供文本提示和输入图像，输入图像将作为根据您的提示进行编辑的基础。

创建请求

curl -X POST \
  'https://api.bfl.ai/v1/flux-kontext-pro' \
  -H 'accept: application/json' \
  -H "x-key: ${BFL_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "<您想要在图像上编辑的内容>",
    "input_image": "<base64 转换的图像>",
  }'

轮询结果

提交请求后，您需要使用返回的 polling_url 进行轮询以在准备就绪时检索输出。

while true; do
  sleep 0.5
  result=$(curl -s -X 'GET' \
    "${polling_url}" \
    -H 'accept: application/json' \
    -H "x-key: ${BFL_API_KEY}")
  
  status=$(echo $result | jq -r .status)
  echo "Status: $status"
  
  if [ "$status" == "Ready" ]; then
    echo "Result: $(echo $result | jq -r .result.sample)"
    break
  elif [ "$status" == "Error" ] || [ "$status" == "Failed" ]; then
    echo "Generation failed: $result"
    break
  fi
done

参数说明

Flux-1-Kontext 默认创建 1024x1024 图像。使用 aspect_ratio 调整尺寸，同时保持相同的总像素数。

• 支持范围：宽高比可以从 3:7（纵向）到 7:3（横向）
• 默认行为：如果未指定 aspect_ratio，模型将默认为标准宽高比，如 1:1（例如 1024x1024）