gemini-3-pro-image API

正確なモデル ID gemini-3-pro-image を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力gemini-3-pro-imagePOST /v1beta/models/gemini-3-pro-image:generateContent

パラメータ: size=2Kratio=16:9

プロンプト： Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text.

このサンプルを作成したリクエスト

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

認証とエンドポイント

https://modelflare.dev で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/models/{model}:generateContent です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

画像の生成

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

リクエストメモ

Gemini イメージ モデルはネイティブ contents および generationConfig を使用します。編集では、テキスト指示と inline_data を同じ parts[] で送信します。

リクエストパラメータ

Gemini イメージ モデルはネイティブ Gemini generateContent を使用します。テキストと参照画像を同じ contents[].parts[] に配置します。画像はinline_dataを使用しています。これらのモデルを /v1/images/generations、/v1/images/edits、または OpenAI /v1/responses に送信しないでください。 imageSize 列挙型はモデル固有であり、以下に示します。

フィールド	必須	注意事項
contents[].parts[].text	はい	テキストプロンプトまたは編集指示
contents[].parts[].inline_data	いいえ	Base64画像データとMIMEタイプ
contents[].parts[].inline_data.mime_type	いいえ	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	いいえ	Base64 でエンコードされた参照画像コンテンツ
generationConfig.responseModalities	はい	["IMAGE"]または["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	いいえ	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	いいえ	1K / 2K / 4K

応答および入力制限

Proは、1K、2K、4Kと1:1、4:3、3:4、16:9、9:16をサポートしています。公式ドキュメントでは参照イメージ数の上限が公開されていないため、ゲートウェイはローカルの上限を追加しません。

画像編集例

編集指示と参照画像を同じcontents[].parts[]に入れます。 inline_data.data は Base64 画像コンテンツです。 Gemini イメージ モデルを OpenAI イメージまたは Responses エンドポイントに送信しないでください。

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

応答形状

candidates[].content.parts[] を読み取ります。応答にはテキスト部分と画像部分が一緒に含まれる可能性があるため、すべての部分が画像であると想定しないでください。

フィールド	注意事項
candidates[].content.parts[].inline_data	生成された画像の MIME タイプと Base64 データ
candidates[].content.parts[].text	TEXT が要求されたときにテキスト キャプションが返されました
candidates[].finishReason	完了または安全上の理由
usageMetadata	サービスによって返されたときの入出力トークンの使用法

Modelflare は、gemini-3-pro-image のネイティブ Gemini 応答形状を保存し、使用可能な画像部分を保持します。

エラーと失敗したタスク

ネイティブ Gemini リクエストからのフィールド エラー、サイズ/比率制限、および安全性の拒否は、Gemini 互換のエラー応答のままです。ゲートウェイはそれらを OpenAI Images 応答として書き換えません。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

このモデルはトークンベースの課金を使用します。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。