Skip to main content
Returns a list of available models in Google Gemini API format.

​
Query Parameters

​
pageSize
integer
Maximum number of models to return. Default: 1000, maximum: 1000.
​
pageToken
string
Continuation token returned by a previous page. Pass it back unchanged to fetch the next slice.

​
Authentication

Authentication is not required for the public model catalog read endpoints. Gemini-style auth hints such as ?key= or x-goog-api-key do not change the response contract here.

​
Response

​
models
array
Array of model objects.
​
nextPageToken
string
Returned when more models are available. Pass this value as pageToken to continue pagination.

​
Errors

  • Invalid pageToken returns 400 INVALID_ARGUMENT.
  • Unexpected list failures return 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
    }
  ]
}