FLUX 3 Image Klein

クイックサンプル

画像 1 枚のリクエストを送信し、返された id を保存して、タスクが completed または failed になるまでポーリングします。この API は非同期タスクを使い、出力を URL で返します。

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

エンドポイントとヘッダー

POST https://api.seedrouter.ai/v1/images/generations

キーはサーバーで管理してください。HTTP の成功はタスクの受理を意味し、画像の完成を意味するものではありません。

パラメータ

受け付けるフィールドは 11 個です。必須なのは model と prompt だけです。任意フィールドを省略すると既定値を使います。null は指定できません。

比率：auto、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。

Playground はモデル固定で、1 に固定した n を含む十個の入力コントロールがあります。管理者を除き、2 を超える安全性の値は API のみで利用できます。

モードと制約

参照なしではテキストから画像を生成します。参照 1 枚なら編集、複数枚なら画像を組み合わせた構図を作れます。auto での編集は最初の参照画像のアスペクト比に従います。テキストのみの生成はプロンプトから構図を選び、判断できなければ 1:1 を使います。解像度の既定値はすべてのモードで 1k です。

解像度区分はおおよその画像規模です。768sq は約 768 × 768、1K は約 1 MP、1.5K は約 2 MP、2K は約 4 MP、4K は約 16 MP です。実際の寸法は返されたファイルで確認してください。

このエンドポイントは width、height、size 内のピクセル寸法、negative_prompt、guidance、grounding、prompt_upsampling、mask、mask_url を受け付けません。不明なフィールドは課金前に HTTP 400 を返します。WebP 出力、base64 入力、ストリーミング、コールバックは提供していません。

参照画像と領域編集

送信前に参照画像を公開 URL にアップロードしてください。リクエストボディには URL を入れ、ファイルのバイト列や data URL は入れません。

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

プレースホルダーの URL を、アクセス可能な自分の画像に置き換えてください。参照には順序があり、最初は ref_image_0 です。バウンディングボックスの指示は独立フィールドではなく prompt 文字列に記述します。座標は [y1, x1, y2, x2] で、0–1000 に正規化します。レイアウトオブジェクトには id、bbox、desc を、編集には id、from、src_bbox、tgt_bbox、desc を使えます。プロンプト内の引用符が適切にエスケープされるよう、リクエスト全体を JSON エンコードしてください。

課金

成功したリクエスト 1 件につき画像 1 枚です。料金は選択した解像度だけで決まり、ステップ数、シード、比率、参照枚数、形式による追加料金はありません。テキスト生成と編集は同料金です。失敗したリクエストは課金されません。現在の料金をご確認ください。

タスクのレスポンスとポーリング

送信時：

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

完了したタスク（URL は例です）：

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

output.data[0].url を読み取ります。特に 4K では生成に最大 10 分を見込んでください。ポーリングは読み取り専用です。クライアントのタイムアウトは、別の有料リクエストを送信してよいという意味ではありません。公開タスクレスポンスに費用やアカウント残高は含まれません。

エラー

HTTP エラーの形式は {"error": {"code": integer, "message": string}} です。共通エラー一覧を参照してください。失敗したタスクは status: "failed" とともにエラーを表示します。無効なパラメータは再送信前に修正し、送信済みリクエストを確認するときはタスク ID を保持してください。

ヒントと関連ガイド

肯定形で説明し、維持する領域や細部を指定してください。ステップを減らすと品質が変わる場合がありますが、料金は下がりません。一度に一つの変更を比較してください。

• FLUX 3 Image Klein Playground
• ダウンロード・重み・ComfyUI ガイド
• タスクのライフサイクル