google/gemini-3-pro-image-preview

導入前の確認事項

以下は MaxAPI の公開設定です。選択したルートに追加の入力条件や利用条件がある場合があります。

リクエストのモデル ID

google/gemini-3-pro-image-preview

出力の種類

画像

Base URL

https://api.maxapi.dev

生成フロー

同期応答／非同期タスク

参照画像・MaxAPI 設定上限

14

解像度とサイズ

1K / 2K / 4K · aspect_ratio + resolution

参照素材には実際の画像を使用してください。HTML のエラーページ、PDF、拡張子だけ変えたファイルは使えません。完全にデコードできるか確認し、容量だけでなくピクセル寸法も確認します。まず 1 枚でテストしてから枚数を増やしてください。

モデルの特徴と選び方

出典確認 · 2026-09-10

このモデルの出典: Google · gemini-3-pro-image · Google · Nano Banana image generation

比較するとよい用途

階層のあるポスター、ブランド素材、複数の商品を同じ画面に配置する作業で比較します。事実や綴りは生成任せにせず指定してください。

制限と注意点

画像内の文字は校正が必要です。Google が記載する検索機能の MaxAPI での有効化は保証しません。公式ページが安定版 ID でも、MaxAPI では上記 preview 付き ID を使います。

提供元の能力説明は MaxAPI の全機能を示すものではありません。この入口に記載したパラメータ、入力、ルートを使用してください。速度や品質の位置付けはサービス保証ではありません。

MaxAPI でのリクエスト処理

ルートと料金

公開ルート：official、official-cheap、mix。画像／動画の JSON リクエストでは route_mode、Gemini ネイティブでは X-MaxAPI-Route-Mode を指定します。制限付きルートにはアカウントと API キー両方の権限が必要です。ルートは接続先と課金の選択であり、別の公開モデル ID ではありません。

1 クレジット = 1 米ドル。以下はカタログの基本料金で、アカウントの見積額ではありません。最終料金はアカウント倍率と有効な課金設定で決まります。トークン単価は画像 1 枚の固定料金ではありません。

最初のリクエスト

MaxAPI の API キーを作成し、サーバー環境に MAXAPI_KEY を設定します。ブラウザーのコードには埋め込まないでください。ルートを指定しない例では、API キーのルート設定を使用します。

• POST /v1/images/generations
• POST /v1/images/edits
• GET /v1/images/generations/{task_id}
• GET /v1/images/edits/{task_id}
• POST /v1beta/models/gemini-3-pro-image-preview:generateContent (Gemini-native)
• GET /v1beta/operations/{task_id} (async polling for the Gemini-native endpoint)

同期呼び出しは結果を待ちます。画像を非同期で生成するには JSON に async: true、Gemini ネイティブでは X-MaxAPI-Async: true を指定します。返されたタスク ID を保存し、上記の対応する GET エンドポイントを問い合わせてください。

curl -X POST "https://api.maxapi.dev/v1/images/generations" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3-pro-image-preview",
    "prompt": "a clean product photo of a glass cube",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

curl "https://api.maxapi.dev/v1/images/edits" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -F "model=google/gemini-3-pro-image-preview" \
  -F 'prompt=Keep the product unchanged and replace the background with a soft gray studio backdrop.' \
  -F 'image=@reference.png' \
  -F 'aspect_ratio=1:1'

{
  "id": "example-task-id",
  "object": "image.generation.task",
  "status": "queued",
  "model": "google/gemini-3-pro-image-preview",
  "poll_url": "/v1/images/generations/example-task-id"
}

HTTP ステータスだけでなく症状で判断する