List models
Retrieve enabled Router model editions, enforced limits, and observed provider counts.
GET
/v1/models Bearer tokenReturns every model edition enabled for the developer API, including editions with no provider currently online.
Example request
curl "$ROUTER_BASE_URL/models" \ -H "Authorization: Bearer $ROUTER_API_KEY"Response
{ "object": "list", "data": [ { "id": "gemma3:1b", "object": "model", "title": "Gemma 3 1B", "brand": "Gemma", "owned_by": "Google", "digest": "sha256:example", "context_length": 4096, "max_output_tokens": 512, "max_prompt_bytes": 3072, "capabilities": ["text"], "ready_providers": 2, "online_providers": 3 } ]}The values are illustrative. Always use the current response.
Model fields
| Field | Meaning |
|---|---|
id | Exact edition ID to send in a chat request. |
title, brand, owned_by | Display metadata for the model. |
digest | Exact configured model artifact revision. |
context_length | Maximum combined context tokens enforced for the edition. |
max_output_tokens | Maximum accepted max_tokens value. |
max_prompt_bytes | Maximum combined UTF-8 bytes across message text. |
capabilities | Capabilities of this enabled API edition. |
ready_providers | Matching providers currently free to accept a request. |
online_providers | Matching connected providers, including busy ones. |
Errors
Authentication failures return 401. Account request limits return 429. A required account or catalog dependency can return 503. Error responses use the common error envelope.
Next, send the selected ID to chat completions.