FLUX.3 Image API の使い方？5 分で最初の 1 枚を生成

TL;DR

• FLUX.3 Image は Black Forest Labs が 2026 年 10 月にリリースした画像モデルで、モデル名は flux-3-image。1 つのモデル名でテキストからの生成と画像編集の両方を扱い、編集では最大 10 枚のリファレンス画像を渡せます。モデルページを開くとオンラインで試せます。
• 枚数課金：1K（デフォルト）$0.048、2K $0.10、4K $0.607、10 月 31 日までは各プラン 20% オフ。1 回のタスクで 1 枚出力。
• 最速の呼び出し方：POST /v1/tasks に prompt を渡し、success になるまでポーリングして output[0].url をダウンロード。必ず resolution を明示し、失敗ステータスは fail と failed の両方を判定すること。

FLUX.3 Image とは、何が新しい？

• 生成と編集が 1 つのモデル名。 image_urls を渡さなければテキストからの生成、1〜10 枚のリファレンス画像を渡せばリファレンス画像を軸に編集します。プロンプトには各画像が何を担当するかを明記してください。
• 5 段階の解像度：768（$0.041）から 4K（$0.607）まで。15 種類のアスペクト比を 21:9 から 9:21 まで用意し、ほかに auto もあります。
• Web 検索で細部を補完。 grounding はデフォルトで有効で、生成前に Web ページや画像を検索して画面の情報を補えます。
• Artificial Analysis のテキスト to 画像ランキングで 9 位。

1.5K、3:2 の室内画像：

Architectural interior photograph of a cedar alpine reading cabin,
floor-to-ceiling window opening onto a misty mountain lake, linen armchair and a
small brass lamp, warm wood grain, quiet morning atmosphere, restrained
Scandinavian design, no text.

このプロンプトで生成 →（1.5K、3:2）

flux-3-image、1.5K、3:2、$0.07。

2 つの導入ルート

オンライン試用（コード不要）：

1. FLUX.3 Image モデルページを開き、ログインします（新規登録で 200 クレジット進呈）。
2. プロンプトを貼り付け、解像度とアスペクト比を選び、必要ならリファレンス画像をアップロードします。
3. 生成をクリックし、結果をダウンロードします。

API 呼び出し：

1. コンソールで API Key を作成します。
2. POST /v1/tasks に "model": "flux-3-image" を指定します。
3. GET /v1/tasks/{taskId} をポーリングするかコールバックを受け取り、output[0].url を保存します。

curl：最初の 1 枚を生成

1K、4:3、$0.048：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image",
    "input": {
      "prompt": "A refined still life of a terracotta architectural model on ivory paper, brass desk lamp, olive leaves, soft late-afternoon sunlight, no text",
      "resolution": "1K",
      "aspect_ratio": "4:3"
    }
  }'

レスポンスには data.taskId が含まれます。GET /v1/tasks/{taskId} をポーリングし、status が success になったら output[0].url をダウンロードします。

Python：送信、ポーリング、ダウンロード

# pip install requests; export HIAPI_KEY=あなたのKey
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=300, **inp):
    # 同じ送信をリトライするときは同じ Idempotency-Key を再利用すると、課金は 1 回だけ
    r = requests.post(API, json={"model": "flux-3-image", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

url = generate(
    prompt="A cinematic rainy Tokyo side street at blue hour, a small bookstore with warm amber windows, a red bicycle outside, no readable signs",
    resolution="2K", aspect_ratio="16:9",
)
ext = url.split("?")[0].rsplit(".", 1)[-1]  # 返却されたファイル形式で保存
with open(f"street.{ext}", "wb") as f:
    f.write(requests.get(url).content)

リファレンス画像で編集

image_urls（1〜10 枚の公開リンク）を渡し、プロンプトには各画像が何を提供するか、何を持ち込まないかを明記します。次の例は 3 枚の合成です：画像 1 から主体、画像 2 からシーン、画像 3 からは配色だけを借ります。

Create a refined product photograph. Use the cobalt blue ceramic teapot and
walnut handle from Image 1 as the main subject, place it on a pale stone side
table inside the cedar reading cabin from Image 2. Borrow only the subtle teal
and amber lighting palette from Image 3. Preserve the teapot shape and glaze,
keep the lake window visible in the background, realistic scale, no lettering.

url = generate(
    prompt=open("teapot_prompt.txt").read(),
    image_urls=[
        "https://your-cdn.example.com/teapot.jpg",   # 画像 1：主体
        "https://your-cdn.example.com/cabin.jpg",    # 画像 2：シーン
        "https://your-cdn.example.com/street.jpg",   # 画像 3：配色だけを借用
    ],
    resolution="1K", aspect_ratio="3:2",
)

flux-3-image、リファレンス画像 3 枚、3:2、$0.048。リファレンス画像による追加料金はありません。

パラメータ早見表

フィールド	値	説明
prompt	文字列、必須、最大 5000 文字	画面を描写する、または何を変更し何を保持するかを明記する
image_urls	1〜10 枚の公開リンク、任意	渡さなければテキストからの生成
resolution	768 / 1K / 1.5K / 2K / 4K、デフォルト 1K	価格を決める。実際の幅と高さはアスペクト比に応じて変わる
aspect_ratio	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、デフォルト auto	固定の版位には比率を明示して選ぶ
safety_tolerance	0〜4、デフォルト 2	0 が最も厳格
grounding	ブール値、デフォルト true	生成前に Web ページと画像を検索する

公開前の注意点

• 毎回 resolution を書く。 誤って 4K と書くと、1 枚が $0.048 から $0.607 になります。
• fail と failed の両方を判定する。 ドキュメントには failed と書かれていますが、両方を判定するほうが安全です。
• ポーリングの代わりにコールバックを使う：input と同じ階層に "callback": {"url": "https://your-app.example.com/hiapi/callback"} を追加し、taskId で重複排除します。
• 結果はすぐ保存する。 output[0].url には有効期限があるため、速やかにダウンロードするか、タスク作成時に永久保存を選びます。
• Idempotency-Key リクエストヘッダーを付ける。リトライ時に同じ Key ならタスクは 1 回だけ作成されます。

よくある質問

1 回のタスクで何枚出力されますか？

1 枚です。複数の方向性が欲しい場合はタスクを分けて送信してください。

PNG や JPEG を選べますか？

このモデルは形式の選択に対応していません。特定の形式が必要な場合は、ダウンロード後に変換してください。

Web 検索はいつオフにしますか？

すでに自分のリファレンス画像があり、制作の方向性も決まっているときです。grounding: false と書いても価格は変わりません。

生成に失敗したら課金されますか？

課金されません。画像の生成に成功した場合のみ課金されます。

各プランの価格はFLUX.3 Image API の価格、更多提示詞はFLUX.3 Image プロンプト事例、前世代との同プロンプト比較はFLUX.3 Image vs FLUX.2をご覧ください。直接モデルページでこのシダー材のキャビンを生成することもできます。