Skip to content

List Endpoints for a Model

GET/v1/models/{model_id}/endpoints

Overview

Public, like the model list; a key that is sent is checked.

Routing and provider details

Send the model ID URL-encoded, or as OpenRouter's two path segments: GET /v1/models/openai/gpt-5.5/endpoints.

A language model returns OpenRouter's endpoints document: the model with an endpoint for each host that serves it now, carrying that host's routing tag, published quantization, price, context, output cap, supported parameters and expiration_date; its uptime, time to first token and throughput over the last 30 minutes; and its uptime over the last day (uptime_last_1d). All are measured from AudioLab's own traffic and are null without any. A ~author/family-latest alias answers for the newest offered model of its family. A language model that is switched off or retired returns 404. Any other model returns its endpoint list, empty once the model is withdrawn; an endpoint measured in the last day carries its uptime.

Authorization

Authorizationstring · headerRequired

AudioLab API key sent as Bearer <token>. Authentication guide

Parameters

model_idpath · stringRequired

Exact model slug or route alias.

Responses

200Endpoint list, or the endpoints document for a language model.
application/json
dataobject[] | objectRequired
Show nested fields
Option 1: object[]
idstringRequired
modelstringRequired
providerstringRequired
taskstringRequired

Values: "llm""transcription""speech""s2s""embeddings""moderation""images""videos""ocr""rerank""music""audio""classification""vision"

statestringRequired

Values: "active""preview""degraded""disabled"

regionsstring[]

The region codes the endpoint satisfies (eu and nl for an endpoint in the Netherlands), or global or unknown.

Show nested fields

See the OpenAPI schema for this nested object.

data_regionstring

Where the endpoint processes requests, as its provider documents it for the host AudioLab calls: us, eu, a country code, global (several regions with no fixed one) or unknown (not documented). Only us, eu and country codes satisfy provider.data_region.

data_region_countrystring

The EU member state, when the provider names one.

data_region_sourcestring | null

The provider's page that documents the region; null when none does.

data_region_checkedstring | null

The day that page was read.

featuresobjectRequired
Show nested fields

See the OpenAPI schema for this nested object.

priceobjectRequired
Show nested fields

See the OpenAPI schema for this nested object.

limitsobject
Show nested fields

See the OpenAPI schema for this nested object.

latency_msinteger | null
speed_factornumber | null
err_ratenumber | null
uptimenumber | null

Share of attempts that succeeded over the last day, 0 to 1; null without any.

Option 2: object
idstringRequired
namestringRequired
createdinteger | null
descriptionstring
architectureobject
endpointsobject[]Required
Show nested fields

See the OpenAPI schema for this nested object.

401Authentication is missing or invalid.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

404Resource was not found.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

429Rate limit exceeded.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

500Internal server error.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.