参照画像の入力エラーを防ぐ

編集エンドポイント、参照順序、実際の画像形式、モデル固有の上限を確認してから入力枚数を増やします。

技術確認日: 2026-09-16

参照画像には編集エンドポイント

MaxAPI は POST /v1/images/edits で JSON の URL 参照を受け付けます。1 枚は image_url、複数は順序付きの image_urls を使い、model、prompt、モデルに合った出力パラメーターを指定します。これは MaxAPI の例で、他社 SDK の JSON 形式を保証しません。最初は自分が権利を持つ非機密画像 1 枚で、小さな対応解像度の出力を 1 枚試してください。

{
  "model": "google/gemini-3.1-flash-image-preview",
  "prompt": "Keep the product from image 1; use the background colors from image 2.",
  "image_urls": ["https://YOUR_ASSET_HOST/product.png", "https://YOUR_ASSET_HOST/background.png"],
  "resolution": "1K", "aspect_ratio": "1:1", "n": 1, "async": true
}

拡張子だけでなく内容を検証

URL を実際に取得可能な HTTPS 画像 URL に置き換えてください。.png で終わっても、ログイン画面、HTML エラー、期限切れ署名 URL、空ファイルは画像ではありません。ローカルでデコードして寸法と形式を調べます。特殊な色モードや破損が疑われる場合は、自分の元画像を一般的な RGB PNG/JPEG に書き出して検証します。変換は診断手順であり、すべての 400 を直す保証ではありません。

順序と上限を明確にする

プロンプトで「画像 1 は物体、画像 2 は配色」のように役割を指定し、修正後も配列の順序を保ちます。Nano Banana や GPT Image の全バージョンが 14 枚を受け付けると考えないでください。Lite などは上限が異なり、選択ルートも編集対応が必要です。共通の一律上限ではなく、下の各モデルページを確認してください。

問題の参照画像を切り分ける

「image 1」と出たら最初に送ったファイルと実際の取得応答を確認します。1 枚で基準を作り、権利のある画像を少しずつ追加して順序を記録します。ファイル検証とコンテンツポリシーを混同しないでください。451 は無効な画像ファイルと同じではなく、502 だけで参照枚数が非対応とも断定できません。診断共有時は非公開 URL やプロンプトを伏せます。

モデル別パラメーター

公開設定のスナップショットであり、現在の稼働状況ではありません。パラメーター、ルート、参照画像の上限は各モデルページを確認してください。

Gemini 3.1 Flash Lite Image google/gemini-3.1-flash-lite-image
Gemini 3.1 Flash Image Preview google/gemini-3.1-flash-image-preview
Nanobanana Pro google/gemini-3-pro-image-preview
GPT Image 2 openai/gpt-image-2

参照資料

API リファレンス

次のステップ

API キーを管理 API リファレンス現在の料金を確認