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 などの専用モデルを使用してメディアを生成するためのエンドポイント。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 キーを使用するをご覧ください。