Gemini nativo

Listar modelos

Lista los modelos disponibles usando el formato de Google Gemini API

GET
/v1beta/models

Devuelve una lista de modelos disponibles en formato de Google Gemini API.

Parámetros de consulta

pageSizeintegerquery

Número máximo de modelos a devolver. Predeterminado: 50, máximo: 1000.

pageTokenstringquery

Token de continuación devuelto por una página anterior. Envíalo tal cual para obtener el siguiente bloque.

Autenticación

La autenticación no es obligatoria para los endpoints públicos de lectura del catálogo de modelos.

Los indicios de autenticación al estilo Gemini, como ?key= o x-goog-api-key, no cambian el contrato de respuesta aquí.

Respuesta

modelsarray

Array de objetos de modelo.

nextPageTokenstring

Se devuelve cuando hay más modelos disponibles. Pasa este valor como pageToken para continuar la paginación.

Errores

  • Un pageToken inválido devuelve 400 INVALID_ARGUMENT.
  • Los fallos inesperados de listado devuelven 500 INTERNAL.

Solicitud

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

Respuesta

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"
    }
  ]
}

Parámetros de consulta

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

Respuesta

application/json

application/json

application/json