FLUX 3 Image Klein API ガイド：5段階の解像度料金、パラメータ、呼び出し例

FLUX 3 Image Klein とは

FLUX 3 Image Klein は Black Forest Labs の FLUX 3 シリーズに含まれる軽量画像モデルです。HiAPI 上ではモデル ID は1つだけ：flux-3-image-klein で、テキストからの画像生成も参照画像編集もこれを使います。プロンプトだけを書けばテキストからの画像生成、さらに image_urls を加えれば参照画像に基づく画面の変更や、複数画像のスタイルを融合させた生成になります。

その強みは安価で段階が多いこと：768 から 4K まで全5段階の解像度があり、バッチ生成や、まず小さい画像で試作してから大きい画像で最終稿を仕上げるワークフローに適しています。

料金：解像度の段階ごとに1枚単位で課金

• 768：$0.0092 / 枚
• 1K（デフォルト）：$0.0103 / 枚
• 1.5K：$0.0126 / 枚
• 2K：$0.016 / 枚
• 4K：$0.0412 / 枚

参照画像には追加料金はなく、1枚でも10枚でも同額です。steps を下げても安くはならず、料金は resolution のみで決まります。タスクが失敗した場合は全額返金されます。

例を挙げると：768 段階でスタイル案を50枚試すと $0.46、その中から5枚を選んで 4K で最終稿を出すと $0.206 です。

パラメータ

model と prompt 以外はすべて任意パラメータです：

• prompt：必須、1〜5000文字。
• resolution：768、1K、1.5K、2K、4K、デフォルトは 1K。
• aspect_ratio：16個の選択値があり、21:9、2:1、16:9、3:2、7:5、4:3、5:4、1:1、4:5、3:4、5:7、2:3、9:16、1:2、9:21 および auto（デフォルト）を含みます。
• image_urls：公網からアクセス可能な参照画像を1〜10枚。指定しなければ純粋なテキストからの画像生成になります。
• steps：1〜16、デフォルトは16。ステップ数が少ないほど生成は速くなりますが、細部が減ることがあります。
• seed：0〜4294967295。シードを固定すると、同じパラメータでできるだけ近い結果を再現します。指定しなければランダムです。
• safety_tolerance：0〜4、デフォルトは2。数値が大きいほど審査が緩くなります。
• output_format：jpeg（デフォルト）または png。

リクエスト例

画像タスクは非同期です：まずタスクを作成し、その後結果をポーリングします。model はトップレベルに、その他のパラメータは input に入れます。

テキストからの画像生成、2K、4:5 の縦画像、シード固定：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "朝の光に照らされた木製のテーブルに置かれた陶器のコーヒーカップ、浅い被写界深度、暖色系、製品写真",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

この1枚は $0.016 です。

参照画像編集、2枚の画像のスタイルを融合：

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "1枚目の画像にある建築構造を保ち、2枚目の画像の水彩タッチと配色で描き直す",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

作成に成功したら、返されたタスク ID を使って GET https://api.hiapi.ai/v1/tasks/{taskId} をポーリングし、成功後に出力から画像 URL を取得します。

使い方の提案

• まず小さく、後で大きく：768 または 1K に固定 seed を加えてプロンプトを試し、満足したら resolution だけを 2K や 4K に変えてもう一度生成します。
• バッチバリエーション：同じプロンプトで seed だけを変えれば、構図が異なりスタイルが統一された候補群になります。
• 画像編集では何を残すかを明記する：参照画像を使う場合、プロンプトで何を残し何を変えるかを説明すると、目標画面だけを描写するより安定します。

現在の制限

• 1回の呼び出しで返される画像は1枚です。
• 参照画像は最大10枚で、公網の http(s) アドレスである必要があります。
• 透明背景のオプションはなく、png は可逆形式に変わるだけです。