List Models

Last updated August 26, 2026

Returns every currently callable model in OpenAI's response shape, with practical extension fields.

Returns every currently callable model in OpenAI's response shape. The OpenAI SDK's model-listing call can target this endpoint directly.

GEThttps://gateway.amux.ai/v1/models

Authorization

header

AuthorizationstringRequired

Bearer <your Amux key> An Amux key created in the console. If you lose it, you can view it again on the keys page.

Response

200response

All currently callable models. Alongside OpenAI's standard fields, every entry carries Amux extensions such as display_name, aliases, pricing, and providers.

401response

The key is missing or invalid.

Extra fields

Beyond the standard fields, each entry also includes the following extensions. They are not part of the official OpenAI protocol; SDKs usually ignore them, but they are available over direct HTTP calls.

Field	Meaning
`display_name`	Display name
`context_length`	Context window, in tokens
`max_output`	Maximum output tokens per call
`input_modalities` / `output_modalities`	Supported input and output modalities
`capabilities`	Capability flags (reasoning, vision, tools, structured output, and so on)
`aliases`	Other names that reach this same model
`pricing`	Unit price per billing component, each with its own unit and currency
`providers`	The providers offering this model, each with its own pricing and supported parameters

pricing is the discounted starting price, so during a promotion it is the promotional price. The actual charge depends on the provider selected for the request, so check that provider's quote in providers[]. Each entry carries its own unit: per_request is priced per call and input_text per token — six orders of magnitude apart, so check the unit before converting.

Three response shapes on one path

/v1/models is shared by all three compatible protocols. The response shape depends on the auth header used for the request:

Header you send	Response shape
`Authorization: Bearer`	OpenAI (this page)
`x-api-key` and `anthropic-version`	Anthropic
`x-goog-api-key` or `?key=`	Gemini

Gemini also has its own URL, /v1beta/models — see List models (Gemini).

The official SDKs already send the appropriate auth headers, so most clients require no extra handling here.

cURL

curl https://gateway.amux.ai/v1/models \
  -H "Authorization: Bearer $AMUX_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-opus-5",
      "object": "model",
      "created": 1786000000,
      "owned_by": "anthropic",
      "display_name": "Claude Opus 5",
      "context_length": 200000,
      "max_output": 64000,
      "input_modalities": [
        "text"
      ],
      "output_modalities": [
        "text"
      ],
      "capabilities": {},
      "aliases": [
        "<string>"
      ],
      "pricing": {},
      "providers": [
        {}
      ]
    }
  ]
}