Skip to main content
GET
Get Models

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-provider-route
string
default:cost

Upstream routing preference: cost, stable, or fast.

Query Parameters

type
string

Filter by model type, or omit to include all types. Supports text/image/video/music/embedding, ignoring case and surrounding whitespace. Separate multiple types with commas or repeat type to combine them with OR. Unknown or empty values return 400.

Minimum string length: 1
Examples:

"text"

"image"

"video"

"music"

"embedding"

"image,video"

Response

The currently callable model catalog. Example capability values illustrate the response structure; use the values returned by the API.

HTTP 200 response for GET /v1beta/models. Includes the same model catalog as the OpenAI list, with Gemini pagination. Use capabilities.endpoints to identify callable APIs.

models
object[]
required
nextPageToken
string

Included when another page is available. Pass it as pageToken in the next request. Omitted on the last page rather than returned as null.

Minimum string length: 1