Skip to content

List recognition model options

GET
/v1/adapters/stt/info/model
curl --request GET \
--url https://example.com/v1/adapters/stt/info/model \
--header 'Authorization: Bearer <token>'

Supported engine / language / model combinations, each marked when it is the default model for its engine and language. Filters combine with AND. A bare language selects that whole family (ru → every ru-* locale); a locale also selects an engine that lists the language without a region (ru-RU → an engine offering ru). An unmatched language yields an empty page.

engine
string
language
string
model
string
limit
integer
<= 500

Page size, max 500 (default 100); a larger value is rejected with 400.

offset
integer

The matching recognition model options.

Media typeapplication/json
object
items
required
Array<object>
object
engine
required

Engine name, e.g. “gsr@v2”.

string
language
required

Language code, e.g. “en-US”.

string
language_name
required

English language name.

string
language_local_name
required

Language name in its own script.

string
model
required

Model identifier.

string
model_name
required

Human-readable model name; empty when the engine has none.

string
is_default_model
required

Whether this model is the default for its engine and language.

boolean
metadata
required

Capability flags for this engine / language / model combination.

object
auto_punctuation
required

Whether the combination can punctuate the transcript automatically.

boolean
diarization
required

Whether the combination can attribute speech to distinct speakers.

boolean
model_adaptation
required

Whether the combination accepts adaptation hints such as class tokens.

boolean
word_level_confidence
required

Whether the combination reports a confidence score per word.

boolean
profanity_filter
required

Whether the combination can mask profanities in the transcript.

boolean
spoken_punctuation
required

Whether the combination can transcribe spoken punctuation as marks.

boolean
spoken_emojis
required

Whether the combination can transcribe spoken emoji names as emoji.

boolean
launch_readiness
required

Maturity the engine publishes for this combination — GA or Preview; empty when the engine publishes none.

string
total
required

Total matching options, ignoring paging.

integer format: int64
limit
required

Page size applied to this request.

integer
offset
required

Offset applied to this request.

integer
has_more
required

Whether records beyond this page match the query.

boolean
Examplegenerated
{
"items": [
{
"engine": "example",
"language": "example",
"language_name": "example",
"language_local_name": "example",
"model": "example",
"model_name": "example",
"is_default_model": true,
"metadata": {
"auto_punctuation": true,
"diarization": true,
"model_adaptation": true,
"word_level_confidence": true,
"profanity_filter": true,
"spoken_punctuation": true,
"spoken_emojis": true,
"launch_readiness": "example"
}
}
],
"total": 1,
"limit": 1,
"offset": 1,
"has_more": true
}

Invalid request body or parameters

Media typeapplication/json
object
error
required

Stable lower_snake_case usecase code (e.g. scenario_not_found)

string
code
required

Registered machine code — generic ERRxxx by status class (ERR001–ERR020 reserved); entity-prefixed codes (SCN1xx) appear only inside validation details; registry in docs/specifications/error-envelope-design.md, append-only, never renumbered

string
message
required
string
data

Structured details, present only where there is structure to carry: validation failures (topic validation, per-entity errors) and delete conflicts (topic conflict, referencing agents)

object
topic
string
errors

Validation errors keyed by entity

object
scenario
Array<object>
object
code

SCN1xx constructor validation code

string
message
string
summary
string
tree_id
string
node_id
string
output_type
string
duplicate_tree_index
string
duplicate_node_index
string
property
string
invalid_value
string
agents

Ids of the agents referencing the resource a delete was rejected for; first 20 — message carries the total count

Array<string>
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"data": {
"topic": "example",
"errors": {
"scenario": [
{
"code": "example",
"message": "example",
"summary": "example",
"tree_id": "example",
"node_id": "example",
"output_type": "example",
"duplicate_tree_index": "example",
"duplicate_node_index": "example",
"property": "example",
"invalid_value": "example"
}
]
},
"agents": [
"example"
]
}
}

Missing or invalid credentials

Media typeapplication/json
object
error
required

Stable lower_snake_case usecase code (e.g. scenario_not_found)

string
code
required

Registered machine code — generic ERRxxx by status class (ERR001–ERR020 reserved); entity-prefixed codes (SCN1xx) appear only inside validation details; registry in docs/specifications/error-envelope-design.md, append-only, never renumbered

string
message
required
string
data

Structured details, present only where there is structure to carry: validation failures (topic validation, per-entity errors) and delete conflicts (topic conflict, referencing agents)

object
topic
string
errors

Validation errors keyed by entity

object
scenario
Array<object>
object
code

SCN1xx constructor validation code

string
message
string
summary
string
tree_id
string
node_id
string
output_type
string
duplicate_tree_index
string
duplicate_node_index
string
property
string
invalid_value
string
agents

Ids of the agents referencing the resource a delete was rejected for; first 20 — message carries the total count

Array<string>
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"data": {
"topic": "example",
"errors": {
"scenario": [
{
"code": "example",
"message": "example",
"summary": "example",
"tree_id": "example",
"node_id": "example",
"output_type": "example",
"duplicate_tree_index": "example",
"duplicate_node_index": "example",
"property": "example",
"invalid_value": "example"
}
]
},
"agents": [
"example"
]
}
}

Caller has no access

Media typeapplication/json
object
error
required

Stable lower_snake_case usecase code (e.g. scenario_not_found)

string
code
required

Registered machine code — generic ERRxxx by status class (ERR001–ERR020 reserved); entity-prefixed codes (SCN1xx) appear only inside validation details; registry in docs/specifications/error-envelope-design.md, append-only, never renumbered

string
message
required
string
data

Structured details, present only where there is structure to carry: validation failures (topic validation, per-entity errors) and delete conflicts (topic conflict, referencing agents)

object
topic
string
errors

Validation errors keyed by entity

object
scenario
Array<object>
object
code

SCN1xx constructor validation code

string
message
string
summary
string
tree_id
string
node_id
string
output_type
string
duplicate_tree_index
string
duplicate_node_index
string
property
string
invalid_value
string
agents

Ids of the agents referencing the resource a delete was rejected for; first 20 — message carries the total count

Array<string>
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"data": {
"topic": "example",
"errors": {
"scenario": [
{
"code": "example",
"message": "example",
"summary": "example",
"tree_id": "example",
"node_id": "example",
"output_type": "example",
"duplicate_tree_index": "example",
"duplicate_node_index": "example",
"property": "example",
"invalid_value": "example"
}
]
},
"agents": [
"example"
]
}
}

Internal server error

Media typeapplication/json
object
error
required

Stable lower_snake_case usecase code (e.g. scenario_not_found)

string
code
required

Registered machine code — generic ERRxxx by status class (ERR001–ERR020 reserved); entity-prefixed codes (SCN1xx) appear only inside validation details; registry in docs/specifications/error-envelope-design.md, append-only, never renumbered

string
message
required
string
data

Structured details, present only where there is structure to carry: validation failures (topic validation, per-entity errors) and delete conflicts (topic conflict, referencing agents)

object
topic
string
errors

Validation errors keyed by entity

object
scenario
Array<object>
object
code

SCN1xx constructor validation code

string
message
string
summary
string
tree_id
string
node_id
string
output_type
string
duplicate_tree_index
string
duplicate_node_index
string
property
string
invalid_value
string
agents

Ids of the agents referencing the resource a delete was rejected for; first 20 — message carries the total count

Array<string>
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"data": {
"topic": "example",
"errors": {
"scenario": [
{
"code": "example",
"message": "example",
"summary": "example",
"tree_id": "example",
"node_id": "example",
"output_type": "example",
"duplicate_tree_index": "example",
"duplicate_node_index": "example",
"property": "example",
"invalid_value": "example"
}
]
},
"agents": [
"example"
]
}
}