Gemini API リファレンス

この API リファレンスでは、Gemini モデルの操作に使用できる単項 API、ストリーミング API、リアルタイム API について説明します。REST API は、HTTP リクエストをサポートする任意の環境で使用できます。最初の API 呼び出しを開始する方法については、スタートガイドをご覧ください。言語固有のライブラリと SDK のリファレンスをお探しの場合は、左側のナビゲーションの [SDK リファレンス] で該当する言語のリンクに移動してください。

プライマリエンドポイント

Gemini API は、次の主要なエンドポイントを中心に構成されています。

インタラクション（CreateInteraction）（推奨）: Gemini でのビルドに推奨される標準プリミティブ。エージェントワークフロー、サーバーサイドの状態管理、複雑なマルチモーダル、マルチターン会話に最適化されています。
標準コンテンツ生成（generateContent）: リクエストを処理し、モデルの完全なレスポンスを 1 つのパッケージで返す標準の REST エンドポイント。結果全体を待つことができる非インタラクティブなタスクに最適です。
ストリーミングコンテンツ生成（streamGenerateContent）: サーバー送信イベント（SSE）を使用して、生成されたレスポンスのチャンクをプッシュします。これにより、chatbot などのアプリケーションで、より高速でインタラクティブなエクスペリエンスを実現できます。
Live API (BidiGenerateContent): 双方向ストリーミング用のステートフル WebSocket ベースの API。リアルタイムの会話ユースケース向けに設計されています。
バッチモード（batchGenerateContent）： generateContent リクエストのバッチを送信するための標準 REST エンドポイント。
エンベディング（embedContent）: 入力 Content からテキストエンベディングベクトルを生成する標準 REST エンドポイント。
Gen Media API: 画像生成用の Imagen や動画生成用の Veo など、Google の特殊なモデルを使用してメディアを生成するためのエンドポイント。Gemini には、generateContent API を使用してアクセスできるこれらの機能も組み込まれています。
プラットフォーム API: ファイルのアップロードやトークンのカウントなど、コア機能をサポートするユーティリティエンドポイント。

認証

Gemini API へのすべてのリクエストには、API キーを含む x-goog-api-key ヘッダーを含める必要があります。Google AI Studio で数回クリックして作成します。

ヘッダーに API キーが含まれているリクエストの例を次に示します。

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Gemini SDK を使用して API にキーを渡す方法については、 Gemini API キーを使用するガイドをご覧ください。

Gemini API リファレンス

プライマリ エンドポイント

認証

プライマリエンドポイント