Gemini nativo

Obter Modelo

Obter metadados do modelo usando o formato da API do Google Gemini

GET
/v1beta/models/{model}

Retorna metadados para um modelo que aceita requisições Gemini, no formato da API do Google Gemini.

Parâmetros de Caminho

modelstringpathobrigatório

Nome do modelo (por exemplo, gemini-2.5-pro, gemini-3.5-flash). Aliases também são aceitos.

Autenticação

A autenticação não é necessária para o endpoint público de leitura de metadados de modelos.

Resposta

namestring

Nome do recurso do modelo no formato models/{model}.

baseModelIdstring

ID do modelo a ser usado nas requisições. Se o caminho utilizou um alias, este é o modelo para o qual o alias é resolvido.

displayNamestring

Nome do modelo legível por humanos.

inputTokenLimitinteger

Limite máximo de tokens de entrada (janela de contexto). Omitido quando desconhecido.

outputTokenLimitinteger

Limite máximo de tokens de saída. Omitido quando desconhecido.

supportedGenerationMethodsarray

As ações que você pode chamar neste modelo são generateContent, streamGenerateContent e countTokens. Um modelo de embedding que aceita requisições Gemini lista embedContent e batchEmbedContents em seu lugar.

versionstring

Versão do modelo. O padrão é o ID do modelo.

descriptionstring

Descrição do modelo legível por humanos, quando disponível.

temperaturenumber

Temperatura padrão quando o modelo fornece uma.

topPnumber

Valor top-p padrão quando disponível.

topKinteger

Valor top-k padrão quando disponível.

maxTemperaturenumber

Temperatura máxima suportada quando disponível.

Erros

  • Requisições GET inválidas que incluam acidentalmente :generateContent ou :streamGenerateContent retornam 405 METHOD_NOT_ALLOWED.
  • Modelos desconhecidos, e modelos que não aceitam requisições Gemini, retornam 404 NOT_FOUND.

Requisição

curl "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro"

Resposta

Response
{
  "name": "models/gemini-2.5-pro",
  "baseModelId": "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",
    "streamGenerateContent",
    "countTokens"
  ]
}

Parâmetros de caminho

model*string

Nome ou alias do modelo (ex: gemini-2.5-pro)

Resposta

application/json

application/json

application/json

application/json