Gemini nativo

Listar modelos

Listar los modelos disponibles utilizando el formato de la API de Google Gemini

GET
/v1beta/models

Devuelve los modelos que aceptan solicitudes de Gemini, en formato de la API de Google Gemini. El campo supportedGenerationMethods de cada modelo enumera las acciones que puede invocar en él.

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. Páselo sin cambios para obtener la siguiente parte de los resultados.

Autenticación

No se requiere autenticación para los endpoints de lectura del catálogo público de modelos.

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

Respuesta

modelsarray

Matriz de objetos de modelo. Consulte Obtener modelo para ver los campos.

nextPageTokenstring

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

Errores

  • Un pageToken no válido devuelve 400 INVALID_ARGUMENT.
  • Los fallos inesperados al listar devuelven 500 INTERNAL.

Solicitud

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

Respuesta

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

Parámetros de consulta

pageSize?integer

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

Rango1 <= value <= 1000
predeterminado50
pageToken?string

Token de continuación de una página anterior. Un token no válido devuelve 400.

Respuesta

application/json

application/json

application/json