Gemini プロトコル

Gemini generateContent 形式で内容を送信します。

サービスアドレス

このページでは Gemini ネイティブ REST のモデル一覧、コンテンツ生成、ストリーミング、埋め込みを扱います。画像専用パラメータは Gemini ネイティブ画像ガイドを参照してください。

モデルと探索

用途	メソッド	パス
Gemini モデル一覧	GET	/v1beta/models
Gemini 互換モデル一覧	GET	/v1/models

コンテンツ生成

用途	メソッド	パス
generateContent	POST	/v1beta/models/{model}:generateContent
streamGenerateContent	POST	/v1beta/models/{model}:streamGenerateContent

埋め込み

用途	メソッド	パス
embedContent	POST	/v1beta/models/{model}:embedContent
batchEmbedContents	POST	/v1beta/models/{model}:batchEmbedContents
Gemini 互換埋め込み	POST	/v1/engines/{model}/embeddings

最小リクエスト

YOUR_MODEL を実際のモデル ID に置き換え、URL パスに残します。x-goog-api-key: YOUR_API_KEY を優先し、ゲートウェイは Bearer も受け付けます。URL はログに残るため、クライアントが要求しない限りクエリ key は使いません。

curl "https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "接続を確認してください"}]}
    ]
  }'

確認

成功時は候補コンテンツまたは埋め込みが返ります。ストリーミングには streamGenerateContent、埋め込みには embedContent、batchEmbedContents、または互換パスを使います。404 ではモデル ID、パス、Key グループを確認してください。