Gemini nativo

Listar Modelos

Listar modelos disponíveis usando o formato da Google Gemini API

GET
/v1beta/models

Retorna os modelos que aceitam requisições Gemini, no formato da Google Gemini API. O campo supportedGenerationMethods de cada modelo lista as ações que você pode chamar nele.

Parâmetros de Consulta

pageSizeintegerquery

Número máximo de modelos a serem retornados. Padrão: 50, máximo: 1000.

pageTokenstringquery

Token de continuação retornado por uma página anterior. Passe-o de volta inalterado para buscar a próxima fatia.

Autenticação

A autenticação não é necessária para os endpoints de leitura do catálogo público de modelos.

Dicas de autenticação no estilo Gemini, como ?key= ou x-goog-api-key, não alteram o contrato de resposta aqui.

Resposta

modelsarray

Array de objetos de modelo. Veja Obter Modelo para os campos.

nextPageTokenstring

Retornado quando mais modelos estão disponíveis. Passe este valor como pageToken para continuar a paginação.

Erros

  • Um pageToken inválido retorna 400 INVALID_ARGUMENT.
  • Falhas inesperadas na listagem retornam 500 INTERNAL.

Requisição

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

Resposta

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 retornar. Padrão: 50.

Intervalo1 <= value <= 1000
padrão50
pageToken?string

Token de continuação de uma página anterior. Um token inválido retorna 400.

Resposta

application/json

application/json

application/json