Skip to content
Documentation
GuidesAPI ReferenceIntegrations
ArenaPlatform
API Reference/Models and Providers

Get a Model

GET/v1/models/{model_id}

Overview

Public, like the model list; a key that is sent is checked. A model that has been switched off or retired still resolves, with state disabled, its expiration_date and, when it was switched off, disabled_reason.

Authorization

Authorizationstring · headerRequired

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

Parameters

model_idpath · stringRequired

Exact model slug or route alias.

Responses

200Model metadata.
application/json
idstringRequired
namestringRequired
ownerstringRequired
taskstringRequired

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

input_modalitiesstring[]Required
Show nested fields

string

output_modalitiesstring[]Required
Show nested fields

string

statestringRequired

Values: "active""preview""disabled"

languagesstring[]
Show nested fields

string

featuresobject
Show nested fields
batchboolean
streamboolean
diarizationboolean
word_timestampsboolean
segment_timestampsboolean
confidenceboolean
redactionboolean
translationboolean
keytermsboolean
subtitlesboolean
duplexboolean
realtimeboolean
audio_inputboolean
audio_outputboolean
toolsboolean
default_routestring | null
endpointsstring[]Required
Show nested fields

string

expiration_datestring | null

The provider's announced shutdown (UTC date), or null.

disabled_reasonstring

Why a model was switched off; only on a single-model lookup of a withdrawn model.

canonical_slugstring

Language models. The same as id.

createdinteger | null

Language models. Release date as Unix seconds; null when the maker never published one.

descriptionstring
context_lengthinteger

Language models. The most input tokens a request may carry.

architectureobject

Language models.

Show nested fields
modalitystring
input_modalitiesstring[]

What a request may carry. image and file (PDF) parts bill as input tokens.

Show nested fields

string

output_modalitiesstring[]
Show nested fields

string

tokenizerstring
instruct_typenull
pricingobject

Language models. USD per token as decimal strings, what AudioLab charges (the provider's rate minus 15%). "-1" when the price is that of the models that answer.

Show nested fields
promptstring
completionstring
input_cache_readstring
web_searchstring

USD per web search call, query or grounded request with the model's own search; "0" when it cannot search.

top_providerobject

Language models.

Show nested fields
context_lengthinteger
max_completion_tokensinteger | null

The output cap. A request without max_tokens may generate up to it.

is_moderatedboolean
per_request_limitsnull
supported_parametersstring[]

Language models. Request parameters the model's contract honours.

Show nested fields

string

default_parametersobject
supported_endpointsstring[]

Set when a model is served on one API only.

Show nested fields

string

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.