Gemini nativo

Listar modelos

Lista os modelos disponíveis usando o formato da API Google Gemini

GET
/v1beta/models

Retorna uma lista de modelos disponíveis no formato da API Google Gemini.

Parâmetros de consulta

pageSizeintegerquery

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

pageTokenstringquery

Token de continuação retornado por uma página anterior. Envie-o novamente sem alterações para buscar o próximo bloco.

Autenticação

Autenticação não é obrigatória para os endpoints públicos de leitura do catálogo de modelos.

As 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.

nextPageTokenstring

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

Erros

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

Requisição

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

Resposta

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
Intervalo1 <= value <= 1000
pageToken?string

Resposta

application/json

application/json

application/json