TokenLab

Gemini Native

List Models

List available models using Google Gemini API format

GET
/v1beta/models

Returns a list of available models in Google Gemini API format.

Query Parameters

pageSizeintegerquery

Maximum number of models to return. Default: 50, maximum: 1000.

pageTokenstringquery

Continuation token returned by a previous page. Pass it back unchanged to fetch the next slice.

Authentication

Authentication is not required for the public model catalog read endpoints.

Gemini-style auth hints such as ?key= or x-goog-api-key do not change the response contract here.

Response

modelsarray

Array of model objects.

nextPageTokenstring

Returned when more models are available. Pass this value as pageToken to continue pagination.

Errors

  • Invalid pageToken returns 400 INVALID_ARGUMENT.
  • Unexpected list failures return 500 INTERNAL.

Request

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

Response

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-pro",
      "version": "gemini-2.5-pro",
      "displayName": "gemini-2.5-pro",
      "description": "gemini-2.5-pro model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "baseModelId": "gemini-2.5-pro"
    },
    {
      "name": "models/gemini-3.5-flash",
      "version": "gemini-3.5-flash",
      "displayName": "gemini-3.5-flash",
      "description": "gemini-3.5-flash model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "baseModelId": "gemini-3.5-flash"
    }
  ]
}

Query Parameters

pageSize?integer
Range1 <= value <= 1000
pageToken?string

Response

application/json

application/json

application/json