Skip to main content
POST

対応モデル

Flex 専用と明記されたパラメータを除き、以下のパラメータとピクセル制限は 3 つのモデルすべてに適用されます。

認証

string
必須
すべてのエンドポイントで Bearer Token による認証が必要です。API Key の取得:API Key 管理ページで API Key を取得してください。リクエストヘッダーに次の値を追加します:

Body

string
必須
モデル名:
  • flux-2-flex - 詳細な制御が可能な Flex モデル
  • flux-2-pro - 汎用 Pro モデル
  • flux-2-max - 最高品質の Max モデル
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像の生成または編集内容を記述するテキスト。
string
デフォルト:"2MP"
出力解像度の区分:
  • 1MP
  • 2MP - デフォルト
  • 3MP
  • 4MP
ここでの 1MP は 1,048,576 ピクセルです。互換エイリアス:512 / 512P / 1M1MP1K / 10242MP2K / 20483MP4K4MP と同等です。それ以外の値は拒否されます。実際の出力サイズは size にも依存します。
string
デフォルト:"1:1"
出力画像のアスペクト比またはピクセルサイズ。size には auto も指定できます。image_urls を渡した場合は、現在の resolution の設定を維持したまま参照画像のアスペクト比に従います。参照画像がない場合は、デフォルトの 1:1 として処理されます。次のサイズオプションに対応しています:
  • 1:1 - 正方形(デフォルト)
  • 4:3 - 横向き
  • 3:4 - 縦向き
  • 16:9 - ワイドスクリーン
  • 9:16 - 縦向き
  • 3:2 - クラシックな横向き
  • 2:3 - クラシックな縦向き
  • 21:9 - 超ワイド
  • 9:21 - 超縦長
  • auto - 参照画像のアスペクト比に従う
"幅x高さ" 形式のピクセル文字列も指定できます。例:"1024x1536"
integer
正確な出力幅(ピクセル単位)。height と同時に指定する必要があり、各値は 64 以上でなければなりません。どちらか一方だけを指定すると、タスクは失敗します。
integer
正確な出力高さ(ピクセル単位)。width と同時に指定する必要があり、各値は 64 以上でなければなりません。出力の総ピクセル数は 4MP 以下、つまり width × height ≤ 4,194,304 でなければなりません。
array
画像からの画像生成または複数の参照画像の合成に使用する参照画像のリスト。制限:
  • 最大 8 枚の画像に対応
  • 公開アクセス可能な URL または Base64 エンコードされた入力画像に対応しています
  • 出力画像とすべての参照画像の合計ピクセル数は 9MP 以下でなければなりません
string
デフォルト:"jpeg"
出力画像のエンコード形式。jpegpngwebp に対応し、デフォルトは jpeg です。
integer
デフォルト:"1"
生成する画像の枚数。値は 1 でなければなりません。複数枚が必要な場合は、複数のタスクを送信してください。
integer
ランダムシード。同じシードとその他のパラメータを使用すると、同じ結果を再現できます。省略した場合はランダムに生成されます。
boolean
デフォルト:"false"
プロンプト強化を有効にするかどうか:
  • true - 有効
  • false - 無効(デフォルト)
明示的に false を設定すると、プロンプトの書き換えを無効にできます。
integer
デフォルト:"2"
コンテンツ審査の許容度。範囲は 0~5 です。値が大きいほど審査の許容度が高くなります。
integer
デフォルト:"50"
サンプリングステップ数。flux-2-flex でのみ使用できます。範囲は 1~50 です。値を大きくすると、通常はディテールが増える一方で生成時間が長くなります。
number
デフォルト:"5.0"
プロンプトガイダンス強度。flux-2-flex でのみ使用できます。範囲は 1.5~10 です。値を大きくすると、通常は生成結果がプロンプトにより忠実になります。

解像度対応表

サイズパラメータの優先順位

  1. widthheight を両方指定すると、正確なピクセルサイズになります。
  2. size1024x1536 のようなピクセル文字列を指定すると、正確なピクセルサイズになります。
  3. それ以外の場合は、resolutionsize のアスペクト比から上の表に従ってサイズが決まります。
  4. サイズ指定を省略した場合は 2MP1:1、つまり 1440×1440 になります。
width または height の一方だけを指定することはできず、タスクは失敗します。

ユースケース例

基本的なテキストからの画像生成
最高品質での生成
正確なピクセルサイズ
複数の参照画像の合成
Flex の詳細制御

Response

送信に成功すると、data は配列として返され、タスク ID は data[0].task_id にあります。
integer
レスポンスステータスコード。
array
レスポンスデータの配列。

タスク結果の照会

タスクは非同期で処理されます。送信レスポンスの task_id を使って次のエンドポイントを呼び出し、ステータスが completed または failed になるまでポーリングしてください:
タスクのステータス: 完了レスポンス例:
result.images[].url は文字列の配列です。このシリーズでは 1 回のリクエストで生成される画像が 1 枚に固定されているため、url[0] を参照してください。画像 URL の有効期限は同じオブジェクト内の expires_at Unix タイムスタンプに従います。期限までに生成結果を保存してください。

無効なモデルパラメータとタスクの失敗

無効なモデルパラメータは非同期で通知されます。送信時は HTTP 200 と task_id が返り、タスクを照会すると最終的に failed となり、具体的な理由が data.error.message に示されます。そのため、必ず最終ステータスまでポーリングしてください。
この種のエラーでは data.error.code は常に task_failed で、具体的な理由は message に記載されます。失敗したタスクは全額返金されます。

注意事項

  1. サイズ制限:出力画像は 4MP 以下で、幅と高さはいずれも 64 ピクセル以上でなければなりません。
  2. 合計ピクセル数の制限:出力画像とすべての参照画像の合計ピクセル数は 9MP 以下でなければなりません。
  3. 参照画像の要件:参照画像は最大 8 件まで指定でき、公開アクセス可能な画像 URL または Base64 エンコードされた入力画像を使用できます。
  4. 固定生成枚数n1 でなければならず、1 回のリクエストで生成される画像は 1 枚です。
  5. プロンプト強化prompt_upsampling はデフォルトで無効です。
  6. Flex 専用パラメータstepsguidanceflux-2-flex でのみ使用できます。
  7. 非同期タスク:送信に成功したら、/v1/tasks/{task_id} をポーリングして最終結果を取得してください。