Saltar al contenido principal
Devuelve una lista de modelos disponibles en formato de Google Gemini API.

Parámetros de consulta

pageSize
integer
Número máximo de modelos a devolver. Predeterminado: 1000, máximo: 1000.
pageToken
string
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

models
array
Array de objetos de modelo.
nextPageToken
string
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.
curl "https://api.aisonar.dev/v1beta/models?pageSize=5" \
  -H "x-goog-api-key: sk-your-api-key"
{
  "models": [
    {
      "name": "models/gemini-2.5-pro",
      "version": "1.0",
      "displayName": "gemini-2.5-pro",
      "description": "gemini-2.5-pro model available via AI Sonar",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": ["generateContent", "countTokens"],
      "temperature": 1.0,
      "topP": 0.95,
      "topK": 40,
      "maxTemperature": 2.0
    },
    {
      "name": "models/gemini-2.5-flash",
      "version": "1.0",
      "displayName": "gemini-2.5-flash",
      "description": "gemini-2.5-flash model available via AI Sonar",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": ["generateContent", "countTokens"],
      "temperature": 1.0,
      "topP": 0.95,
      "topK": 40,
      "maxTemperature": 2.0
    }
  ]
}