> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # FLUX 3 Image 画像生成 > テキストからの画像生成、単一画像の編集、最大 10 枚の参照画像に対応。複数のアスペクト比と最大 4k の解像度を提供します。 この API は非同期です。送信に成功すると `task_id` が返ります。[タスク照会](/ja/api-reference/tasks/status)で状態と画像を取得し、`completed` または `failed` になったらポーリングを停止してください。`4k` の生成には数分かかる場合があるため、全体の待機タイムアウトは 10 分を推奨します。 ```bash cURL theme={null} curl --request POST \ --url https://api.apimart.ai/v1/images/generations \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "model": "flux-3-image", "prompt": "夜明けの霧に包まれた海沿いの道路、超ワイドな映画風ショット、ヘッドライトを点灯した一台のクラシックカー", "aspect_ratio": "21:9", "resolution": "2k" }' ``` ```python Python theme={null} import requests response = requests.post( "https://api.apimart.ai/v1/images/generations", headers={"Authorization": "Bearer "}, json={ "model": "flux-3-image", "prompt": "夜明けの霧に包まれた海沿いの道路、超ワイドな映画風ショット、ヘッドライトを点灯した一台のクラシックカー", "aspect_ratio": "21:9", "resolution": "2k" } ) print(response.json()) ``` ```javascript JavaScript theme={null} const response = await fetch("https://api.apimart.ai/v1/images/generations", { method: "POST", headers: { Authorization: "Bearer ", "Content-Type": "application/json" }, body: JSON.stringify({ model: "flux-3-image", prompt: "夜明けの霧に包まれた海沿いの道路、超ワイドな映画風ショット、ヘッドライトを点灯した一台のクラシックカー", aspect_ratio: "21:9", resolution: "2k" }) }); console.log(await response.json()); ``` ```json 200 theme={null} { "code": 200, "data": [ { "status": "submitted", "task_id": "task_01K..." } ] } ``` ## リクエストヘッダー Bearer 認証。形式は `Bearer ` で、`` は APIMart API Key です。 ## リクエストパラメータ `flux-3-image` 固定です。 テキストから生成する画像の説明、または画像編集の指示。ネガティブプロンプトは非対応です。生成したい内容を肯定的に記述してください。 `prompt` 内のタグと bbox JSON でレイアウトや部分編集の領域を指定できます。以下の例をご覧ください。 参照画像のリスト。最大 10 枚に対応し、公開アクセス可能な HTTP(S) URL または Base64 入力を使用できます。 省略するとテキストから画像を生成します。1 枚を指定すると単一画像の編集、複数枚を指定すると複数画像を参照できます。 出力アスペクト比。対応値： `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`。 `16x9` 形式の比率表記にも対応します。`auto` の場合： * 編集または複数画像参照：最初の参照画像の比率に従います。 * テキストからの生成：プロンプトに基づいて決定し、比率が決まらない場合は `1:1` を使用します。 アスペクト比の互換パラメータです。`aspect_ratio` の代わりに使用でき、同じ値を受け付けます。どちらか一方のみを使用することを推奨します。 `1024x1024` などのピクセルサイズは非対応で、指定すると HTTP 400 が返ります。出力解像度は `resolution` で選択してください。 出力解像度。`768sq`、`1k`、`1.5k`、`2k`、`4k` に対応し、大文字・小文字は区別しません。`768` は `768sq` と同等です。 このパラメータで課金区分が決まります。省略時は `1k` で生成・課金されます。`3k` などの非対応値は HTTP 400 を返します。 コンテンツ安全性の許容度。範囲は 0–4 で、0 が最も厳格です。 生成前のウェブ検索または画像検索を許可するかどうか。`false` で無効にできます。 ブール値で指定してください。文字列の `"false"` や `"true"` は使用できません。 1 リクエストにつき 1 枚を生成し、`1` のみ指定できます。複数枚が必要な場合は個別にタスクを送信してください。1 を超える値は HTTP 400 を返します。 ## 非対応のパラメータ 次のパラメータを指定すると HTTP 400 が返り、黙って無視されることはありません。 * `width`、`height` * `1024x1024` など、ピクセルサイズ形式の `size` * `seed`、`steps`、`guidance` * `output_format`、`negative_prompt`、`prompt_upsampling`、`mask_url` 高解像度には `resolution`、特定の画面比率には `aspect_ratio` を使用してください。 ## 参照画像の編集 ```json theme={null} { "model": "flux-3-image", "prompt": "画像の車を赤色に変更し、元の道路、背景、照明はそのまま残す", "image_urls": ["https://example.com/car.jpg"], "aspect_ratio": "auto", "resolution": "2k" } ``` サンプル URL を公開アクセス可能な画像 URL に置き換えてください。複数画像を参照する場合は、`image_urls` に合計 10 枚以内の URL を指定します。 ## 複数画像の参照 編集、部分編集、レイアウトは本ページの同じ API とモデルを使用し、`resolution` に基づいて課金されます。参照画像は順番に、1 枚目が `ref_image_0`、2 枚目が `ref_image_1` です。プロンプトでは `Image 1` / `Image 2` とも記述できます。 ```json theme={null} { "model": "flux-3-image", "prompt": "Image 1 を Image 2 のスタイルに変換してください。", "image_urls": [ "https://example.com/subject.jpg", "https://example.com/style.jpg" ], "aspect_ratio": "auto" } ``` ## 部分編集（bounding box） `prompt` の先頭に自然言語の編集指示を書き、`` のような `<タグ>` で要素を指定します。同じ文字列の後ろに JSON 配列を追加し、各オブジェクトで 1 つの枠を記述します。bbox は独立したリクエストパラメータではありません。 | フィールド | 説明 | | - | - | | `id` | プロンプト内の要素タグに対応します。山括弧は含めません。 | | `from` | 要素の参照元。例：`ref_image_0`。新規描画や再描画する要素は `null`。 | | `src_bbox` | 元画像内の枠。`from` が `null` の場合はこの値も `null`。 | | `tgt_bbox` | 出力画像内の枠。`src_bbox` と同じなら元の位置に保持し、異なる場合は移動します。 | | `desc` | 要素の変更内容または保持する内容。 | すべての枠フィールド（`src_bbox`、`tgt_bbox`、`bbox`）は `[上, 左, 下, 右]`、つまり `[y1, x1, y2, x2]` を使用します。**0–1000 の正規化座標**で、左上が `[0,0]`、右下が `[1000,1000]` です。ピクセル座標ではありません。 次の例では枠内の車を赤くし、保持する背景を記述します。URL と枠の位置は例なので、実際の画像に合わせて置き換えてください。 ```json theme={null} { "model": "flux-3-image", "prompt": " の車 を赤くし、背景 を保持してください。 [{\"id\":\"car_1\",\"from\":null,\"src_bbox\":null,\"tgt_bbox\":[250,300,750,800],\"desc\":\"元の形状と向きを保った赤い車。\"},{\"id\":\"background_1\",\"from\":\"ref_image_0\",\"src_bbox\":[0,0,1000,1000],\"tgt_bbox\":[0,0,1000,1000],\"desc\":\"元の道路、背景、照明を保持する。\"}]", "image_urls": [ "https://example.com/car.jpg" ], "aspect_ratio": "auto", "resolution": "2k" } ``` ### 要素の移動 次のオブジェクトをプロンプト末尾の bbox 配列に入れます。`from` は元画像、`src_bbox` は元の位置、`tgt_bbox` は新しい位置です。自然言語の指示にも対応する `` タグを使用してください。 ```json theme={null} { "id": "knight_1", "from": "ref_image_0", "src_bbox": [ 500, 150, 850, 350 ], "tgt_bbox": [ 194, 55, 544, 255 ], "desc": "小さな灰色の騎士のあみぐるみ。" } ``` ## テキストからの画像生成のレイアウト 参照画像がなくてもレイアウトを指定できます。各枠は `id`、`bbox`、`desc` を使用します。座標グリッドが画面比率に合わせて伸縮するため、`aspect_ratio` を明示してください。 ```json theme={null} { "model": "flux-3-image", "aspect_ratio": "1:1", "prompt": "純粋な黄緑色の背景 に、走る人物の黒いシルエット を配したミニマルなイラスト。 [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"かすかな紙の質感がある蛍光黄緑色の背景。\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"点描の質感がある走る人物の黒いシルエット。\"}]" } ``` ### 使用上の注意 * bbox JSON は `prompt` 文字列の一部です。リクエスト JSON を手書きする場合、内部の二重引用符を `\"` としてエスケープしてください。SDK や JSON シリアライズでは自動処理できます。 * 保持する領域も列挙し、`desc` に保持内容を記述してください。 * プロンプト内の要素タグと JSON の `id` は一対一で対応させてください。`` などの参照識別子は入力画像を示します。 * このモデルには `mask` パラメータがなく、`mask_url` も非対応です。`mask_url` を指定すると HTTP 400 が返ります。bbox 編集ではマスクのアップロードパラメータを使用しません。 ## 送信レスポンス レスポンスステータスコード。成功時は `200` です。 タスク送信結果。 送信成功時は `submitted` です。生成の完了を意味するものではありません。 タスクの状態と結果を照会するためのタスク ID。 ## タスク結果の照会 ```bash theme={null} curl --request GET \ --url https://api.apimart.ai/v1/tasks/task_01K... \ --header 'Authorization: Bearer ' ``` 成功レスポンスの例（画像 URL はプレースホルダーです）： ```json theme={null} { "code": 200, "data": { "status": "completed", "result": { "images": [ { "url": ["https://example.com/generated-image.jpg"] } ] } } } ``` `data.result.images[0].url` 配列から画像リンクを取得します。状態が `failed` の場合は返されたエラーを確認し、画像を待ち続けないでください。 ## 解像度と課金 画像単位で課金されます。単価は `resolution` のみで決まり、アスペクト比や参照画像の枚数には依存しません。参照画像による追加料金はありません。 | 解像度 | 出力規模の目安 | | - | - | | `768sq` | 約 768×768 | | `1k`（デフォルト） | 約 1MP | | `1.5k` | 約 2MP | | `2k` | 約 4MP | | `4k` | 約 16MP | 出力規模は概算です。実際のピクセルサイズは返された画像を基準にしてください。各解像度の料金は[モデル料金](https://apimart.ai/pricing)をご確認ください。 タスクが失敗した場合、またはコンテンツ審査でブロックされた場合は全額返金されます。 ## よくあるパラメータエラー | リクエスト | 結果と対処方法 | | - | - | | `resolution: "3k"` | HTTP 400。対応する 5 種類の解像度から選択 | | `size: "1024x1024"` | HTTP 400。アスペクト比を指定し、`resolution` で解像度を選択 | | `n: 2` | HTTP 400。1 リクエストにつき 1 枚のみ生成 | | 参照画像 11 枚 | HTTP 400。最大 10 枚に制限 | | `grounding: "false"` | HTTP 400。ブール値 `false` を使用 | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.