BFL FLUX 公式モデル

このページでは、Magick API における BFL 公式 FLUX モデルの統一呼び出し方法を説明します。クライアントは OpenAI 互換の画像エンドポイントを呼び出し、ゲートウェイが BFL の非同期 API に変換して結果をポーリングし、同期的な ImageResponse として返します。

対応モデル

認証とレスポンス

Magick API への呼び出しではプラットフォームの API トークンを使用します。

Authorization: Bearer YOUR_API_KEY

BFL 公式キーは管理画面の BFL チャネルに設定します。クライアントから BFL 上流キーを直接送信しないでください。

成功レスポンスは OpenAI 互換の画像形式です。

{
  "created": 1712345678,
  "data": [
    {
      "url": "https://signed-result-url.example/image.png"
    }
  ],
  "metadata": {
    "id": "bfl-task-id",
    "status": "Ready",
    "cost": 3,
    "input_mp": 0,
    "output_mp": 1
  }
}

"response_format": "b64_json" を指定すると、ゲートウェイが BFL の結果画像を取得し、data[0].b64_json を返します。

共通互換フィールド

FLUX.2 パラメータ

flux2_text_to_image、flux2_image_editing、flux-2-pro-preview に適用されます。

curl --request POST \
  --url https://api.magickapi.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux2_text_to_image",
    "prompt": "A precise product photo of a matte black espresso machine on a white counter",
    "size": "1024x1024",
    "output_format": "png",
    "safety_tolerance": 2,
    "seed": 42,
    "response_format": "url"
  }'

curl --request POST \
  --url https://api.magickapi.com/v1/images/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux2_image_editing",
    "prompt": "Use the chair from image 2 in the room from image 1, keep natural shadows",
    "images": [
      "https://example.com/room.png",
      "https://example.com/chair.png"
    ],
    "size": "1024x1024",
    "output_format": "jpeg",
    "safety_tolerance": 2
  }'

FLUX.1.1 Pro パラメータ

flux-pro-1.1 に適用されます。

FLUX.1 Fill パラメータ

flux_1_fill に適用されます。Magick API の FLUX.1 Fill では、下流クライアントは OpenAI 互換の POST /v1/images/edits を呼び出します。BFL 公式パス /v1/flux-pro-1.0-fill を直接呼び出さないでください。ゲートウェイが model: "flux_1_fill" を上流 BFL モデルへ内部変換します。image、mask、prompt を一緒に指定してください。image と mask は Base64 画像である必要があります。黒は保持、白はインペイントされます。

:::warning[デバッグ]

• image と mask は data:image/...;base64, プレフィックス付き、または純粋な Base64 を指定できます。画像 URL は送信しないでください。URL を送ると “requires base64 image data” が返ります。
• mask は元の image と完全に同じ寸法である必要があります。よくあるフロントエンドの不具合は、原画像 1152x896 に対してプレビューサイズ 720x560 の mask を送ることです。この場合 BFL は 422 を返し、ゲートウェイでは openai_error / bad_response_status_code だけが見えることがあります。
• 安定した OpenAI 互換レスポンスのため、response_format: "url" と output_format: "png" を明示してください。 :::

FLUX Erase パラメータ

flux-erase に適用されます。公式の上流パスは flux-tools/erase-v1 です。

課金

BFL は送信レスポンスに cost、input_mp、output_mp を返す場合があります。Magick API は cost がある場合、それを実際の精算に使用します。動的コストが返らない場合は、バックエンドで設定されたモデル固定価格を使用します。BFL の 1 credit は $0.01 として扱われます。