Models

When to use this pageCopy Anchor Link

You need a model id for a request, want to know what a model supports, or want to list models from code. Prices are on Pricing.

ModelsCopy Anchor Link

The table is live from the catalog. Context is the most input tokens a request can have; max output is the highest max_tokens the model accepts.

Model idsCopy Anchor Link

• The canonical id is author/model, for example anthropic/claude-sonnet-5-5. The author is the company that made the model, not the one that serves it.
• A model also answers to the names in the Aliases column: the provider's own name without the author/ prefix (claude-sonnet-5-5), and for most models the same name with a dot in the version (claude-sonnet-5.5). Claude Code and the Anthropic SDKs send these names, so they work unchanged.
• Ids and aliases are case-insensitive. Spaces around them are ignored.
• Both APIs take the same ids: POST /v1/messages and POST /openai/v1/chat/completions.
• The model in a response is exactly the name you sent, never a provider's internal id. The model lists below always return canonical ids.

StatusesCopy Anchor Link

A retired, unknown or preview model (without preview access) is rejected before it reaches a model, and isn't charged:

{
  "type": "error",
  "error": { "type": "not_found_error", "message": "model: <the name you sent>" },
  "request_id": "…"
}

On the OpenAI-compatible API it is a 404 with "code": "model_not_found" and "param": "model". See Errors.

Preview access is set per API key by EZAT Router; the dashboard has no switch for it. To ask for it, email support@ezat.io.

Keys limited to some modelsCopy Anchor Link

A key created with Only selected models can call only those models. Any other model is refused with 403 permission_error ("This API key is not allowed to use …"), and the key's model lists show only its models. See API keys.

Models without capacityCopy Anchor Link

When no provider can serve a model right now, the public catalog shows it with "available": false and the dashboard's Models page shows Unavailable. Requests for it get 529 overloaded_error (503 on the OpenAI-compatible API) with a retry-after header. See Rate limits.

FeaturesCopy Anchor Link

The public catalog also has a sampling capability. Models with it accept temperature, top_p and top_k. Models without it run only at their default sampling: on /v1/messages the model refuses other values with a 400, and the OpenAI-compatible API drops these fields. The OpenAI-compatible API also drops them whenever thinking is on.

Choosing a modelCopy Anchor Link

Start with the newest model in the family that fits the task. Older models stay in the catalog so existing code keeps working.

Compare costs on Pricing before you pick. Every model in the table above works with both APIs.

List models from the APICopy Anchor Link

There are two kinds of list:

The two keyed lists include active and deprecated models, preview models only when the key has preview access, and only the key's own models when it is limited to some. They don't include prices.

curl -sS --fail-with-body https://api.router.ezat.io/v1/models \
  -H "x-api-key: $EZAT_API_KEY" \
  -H "anthropic-version: 2023-06-01"

The Anthropic list returns everything in one page (has_more is false).

To look up one model, use GET https://api.router.ezat.io/v1/models/{id} or GET https://api.router.ezat.io/openai/v1/models/{id}. {id} can be a canonical id or an alias, and the response has the canonical id. On /v1/models/{id}, write the / of a canonical id as %2F (anthropic%2Fclaude-sonnet-5-5); the SDKs do this for you. A model the key can't call returns 404, or 403 for a key limited to other models.

The public catalogCopy Anchor Link

GET https://api.router.ezat.io/api/models needs no key. It is what this page and Pricing are built from.

curl -sS https://api.router.ezat.io/api/models

Each entry in data has:

Prices are strings, to keep every decimal. Ignore the uuid field: it is internal.

For AI agentsCopy Anchor Link

1. Send the canonical id (author/model) in model. Aliases from the catalog also work, case-insensitively.
2. To see which models a user's key can call, use GET https://api.router.ezat.io/v1/models with the key (x-api-key or Authorization: Bearer), or GET https://api.router.ezat.io/openai/v1/models for OpenAI-format tools.
3. To see every model with prices and capabilities, use GET https://api.router.ezat.io/api/models (no key), or read https://docs.router.ezat.io/models.md.
4. Don't hard-code a model list or prices in code or config you write for the user; read them from the endpoints above.
5. A 404 not_found_error (OpenAI format: model_not_found) means the model is unknown, retired or in preview. Pick another model from the list; retrying won't help.
6. Prefer the newest model of a family. Don't pick a model with the Deprecated badge for new work.