Gemini ネイティブ

モデル一覧の取得

Google Gemini API形式を使用して利用可能なモデルを一覧表示します

GET
/v1beta/models

Google Gemini API形式で、Geminiリクエストを受け付けるモデルを返します。各モデルの supportedGenerationMethods には、そのモデルに対して呼び出し可能なアクションがリストされています。

クエリパラメータ

pageSizeintegerquery

返すモデルの最大数。デフォルトは 50、最大は 1000 です。

pageTokenstringquery

前のページから返された継続トークン。次のスライスを取得するには、これを変更せずに渡してください。

認証

パブリックモデルカタログの読み取りエンドポイントには認証は不要です。

?key= や x-goog-api-key といったGemini形式の認証ヒントは、ここでのレスポンス契約を変更しません。

レスポンス

modelsarray

モデルオブジェクトの配列。フィールドについては モデルの取得 を参照してください。

nextPageTokenstring

さらにモデルが利用可能な場合に返されます。ページネーションを継続するには、この値を pageToken として渡してください。

エラー

  • 無効な pageToken は 400 INVALID_ARGUMENT を返します。
  • 予期しないリスト取得の失敗は 500 INTERNAL を返します。

リクエスト

curl "https://api.tokenlab.sh/v1beta/models?pageSize=2" \
  -H "x-goog-api-key: sk-your-api-key"

レスポンス

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-flash",
      "baseModelId": "gemini-2.5-flash",
      "version": "gemini-2.5-flash",
      "displayName": "Gemini 2.5 Flash",
      "description": "Fast Gemini workhorse for multimodal apps where latency and price matter",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    },
    {
      "name": "models/gemini-2.5-flash-lite",
      "baseModelId": "gemini-2.5-flash-lite",
      "version": "gemini-2.5-flash-lite",
      "displayName": "Gemini 2.5 Flash-Lite",
      "description": "Lean Gemini 2.5 lane for cheap multimodal traffic and quick agents",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    }
  ],
  "nextPageToken": "b2Zmc2V0OjI"
}

クエリパラメータ

pageSize?integer

返すモデルの最大数。デフォルトは 50 です。

範囲1 <= value <= 1000
デフォルト50
pageToken?string

前のページからの継続トークン。無効なトークンは 400 を返します。

レスポンス

application/json

application/json

application/json