Models API

List available models and inspect model metadata.

GEThttps://onerouter.com/v1/models

Authentication

Send your OneRouter API key with every request. OpenAI-compatible clients should use Authorization: Bearer YOUR_API_KEY. Gemini-native clients may also use x-goog-api-key. Keys are issued from the console and use the OneRouter key format.

Authorization: Bearer YOUR_API_KEY

List models

GET /v1/models returns models available to the API key. For Claude-native clients, OneRouter filters known unavailable or duplicate Claude variants by default so client model pickers remain usable. Use keep_all=1 only for debugging raw upstream lists.

curl https://onerouter.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Model detail pages

Use the website model detail pages for richer information: modality, context window, pricing, supported parameters, API examples, availability snapshots, and model-specific notes. Not every model has the same fields because text, image, audio, and video models are billed and operated differently.

Availability monitor

OneRouter exposes public availability snapshots for monitored plaza models. The monitor is best understood as recent health evidence, not a universal SLA for every model and modality.