Skip to main content
POST
モデル名互換のお知らせ:本エンドポイントはエイリアス nano-banana-2-ext にも対応しており、gemini-3.1-flash-image-preview と同等です。両者は互換的に使用でき、効果は同一です。

認証

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

Body

string
デフォルト:"gemini-3.1-flash-image-preview"
必須
画像生成モデル名サポートされているモデル:
  • gemini-3.1-flash-image-preview - 標準版(エイリアス nano-banana-2-ext に対応)
  • gemini-3.1-flash-image-preview-official - 公式版(エイリアス nano-banana-2 に対応)
例:"gemini-3.1-flash-image-preview" または "gemini-3.1-flash-image-preview-official"
旧バージョンの呼び出しとの互換性のため、エイリアス nano-banana-2-extgemini-3.1-flash-image-preview に対応)、nano-banana-2gemini-3.1-flash-image-preview-official に対応)は引き続き正常に使用できます。
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成のテキスト説明
string
画像のアスペクト比サポートされる比率:
  • auto - アスペクト比を自動選択
  • 1:1 - 正方形、アバター、SNS
  • 3:2 / 2:3 - 標準写真
  • 4:3 / 3:4 - 従来のディスプレイ比率
  • 16:9 / 9:16 - ワイドスクリーン/縦型動画カバー
  • 5:4 / 4:5 - Instagram画像
  • 21:9 - ウルトラワイドバナー
  • 1:4 / 4:1 - 長尺ポスター/バナー
  • 1:8 / 8:1 - 極端な長尺画像/バナー広告
テキストから画像生成では、sizeauto の場合、デフォルトは 1:1 または 16:9 です。画像から画像生成では、上流の返却比率に従います。(比率の指定を推奨します)
string
デフォルト:"1K"
出力画像解像度サポートされる値:
  • 0.5K - 約512px、低解像度プレビュー
  • 1K - 約1024px、標準解像度(デフォルト)
  • 2K - 約2048px、高解像度
  • 4K - 約4096px、超高解像度
注意: 解像度によって料金が異なります。4Kは1Kより高額です。
integer
生成する画像の数範囲:1デフォルト:1⚠️ 注意: 数値のみ入力してください(例:1)。引用符を使用するとエラーが発生します
boolean
デフォルト:"false"
公式チャネルのフォールバックを使用するかどうか
  • false:使用しない(デフォルト)
  • true:公式チャネルを使用
公式チャネル(gemini-3.1-flash-image-preview-official)を使用する場合、このパラメータは使用できません。
array
画像から画像生成用の参照画像URLリスト2つの形式をサポート:1. 完全な画像URLアドレス
  • 公開アクセス可能な画像URL(http:// または https://)
  • 例:https://example.com/image.jpg
2. Base64エンコード形式
  • 完全なData URI形式を使用する必要があります
  • 形式:data:image/{形式};base64,{base64データ}
  • サポートされる画像形式:jpeg、png、webp
  • 例:data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 注意:data:image/jpeg;base64, プレフィックスを含める必要があります
制限:
  • 最大 14枚 の参照画像(推奨:最大10枚のオブジェクト参照 + 4枚のキャラクター参照)
  • 1枚あたり10MB以下
  • 対応形式:jpeg、png、webp
Googleテキスト検索強化を有効にする
  • true:モデルがウェブテキスト情報を検索して画像生成を支援します
  • false:無効(デフォルト)
Google画像検索強化を有効にする
  • true:テキスト検索に加えて、参照画像も検索して生成を支援します
  • false:無効(デフォルト)
注意: google_search: true と一緒に使用する必要があります

レスポンス

integer
レスポンスステータスコード
array
レスポンスデータ配列