Models and aliases

Set model to a ModelRail alias. Raw provider model IDs are invalid.

Alias guide

Alias	Use
`modelrail-auto`	Let ModelRail select the appropriate workload alias
`modelrail-chat`	Chat, Q&A, summaries, rewriting, and light NLP
`modelrail-reasoning`	Multi-step reasoning, planning, and trade-offs
`modelrail-code`	Coding, debugging, refactoring, and implementation
`modelrail-tools`	Tool and function-calling workflows

List models

GET/v1/models

Auth · API key

bash

curl "https://api.modelrail.dev/v1/models" \
  -H "Authorization: Bearer $MODELRAIL_API_KEY"

json

{
  "object": "list",
  "data": [
    { "id": "modelrail-auto", "object": "model", "owned_by": "modelrail" },
    { "id": "modelrail-chat", "object": "model", "owned_by": "modelrail" }
  ]
}

The response returns active ModelRail aliases only — not provider mappings or pricing.

Rules

A request using modelrail-auto returns the resolved alias in the response model field. Provider identities are not selectable. See Chat completions for request fields.

Things to note

One compatible fallback may run if the primary fails before customer-visible output. A failed primary may still incur cost even if a fallback succeeds.