Offers
Models by the token: an offer is one catalogue model served by one provider endpoint (`vendor/model@provider`), synthesised into the routing catalogue and sold at the customer price the pricing engine computes.
Models by the token: an offer is one catalogue model served by one provider endpoint (`vendor/model@provider`), synthesised into the routing catalogue and sold at the customer price the pricing engine computes. `GET /offers` is the public storefront (list price next to the price the caller pays, the endpoints with health and traffic); `/admin/offers` and `/admin/providers/{provider_id}/offers` list, pause and remove offers. `POST /v1/chat/completions` accepts `vendor/model` (the router picks the endpoint) and `vendor/model@provider` (one pinned); `GET /v1/models` lists offers in OpenRouter's shape.
get/api/v1/offers
List Offers
Every model this deployment sells, grouped by catalogue id: list price, the customer price (the caller's plan and rules when signed in, else the deployment's public tariff), the endpoints serving it with health and seven-day traffic. Anonymous callers get the public prices.
Requires an API key
Parameters
| Name | In | Type | Default | Description |
|---|---|---|---|---|
| q | query | string | "" | |
| vendor | query | string | null | ||
| provider | query | string | null |
Responses
| 200 | Successful Response |
| 422 | Validation ErrorHTTPValidationError |
| 401 | Missing, invalid or revoked API key |
curl -s "$OSR_URL/api/v1/offers?q=" \
-H "Authorization: Bearer $OSR_API_KEY"get/api/v1/offers/{vendor}/{model}
One Model
One model's endpoints (model may carry a :variant suffix) with prices, health and traffic.
Requires an API key
Parameters
| Name | In | Type | Default | Description |
|---|---|---|---|---|
| vendor(required) | path | string | ||
| model(required) | path | string |
Responses
| 200 | Successful Response |
| 422 | Validation ErrorHTTPValidationError |
| 401 | Missing, invalid or revoked API key |
curl -s "$OSR_URL/api/v1/offers/<vendor>/<model>" \
-H "Authorization: Bearer $OSR_API_KEY"Model providers
Model providers: `GET /providers` is the public, OpenRouter-style view of what this deployment executes on (provider, upstream model, prices, health per executable target - never credentials); the `/admin/providers` endpoints add, check and map OpenAI-compatible endpoints at run time, and every API replica picks the change up without a restart.
Workspace-providers
Bring your own model providers (feature `byok`, on every plan of the default catalogue): a workspace connects its own Azure OpenAI, Amazon Bedrock, Google Vertex AI / Gemini, OpenAI, Anthropic or any OpenAI-compatible endpoint with its own key (stored encrypted, never returned) and maps catalogue targets to models on it.