List Models
Retrieve the public inference model catalog. By default this returns OpenRouter ModelDocumentV2 entries (the provider document); OpenRouter's own SDKs, recognised by their User-Agent, and requests with format=openrouter get OpenRouter's public model list (data, total_count, links) instead, which they can parse. Send the Anthropic-Version header for an Anthropic-compatible model list with cursor pagination. Anthropic mode includes vultr/claude-code/<model-id> aliases because Claude Code only discovers IDs containing claude or anthropic; the original IDs remain available. X-Vultr-Model-Type applies only to the default catalog. TypeSafe's SDKs, which send X-TypeSafe-SDK, get TypeSafe's model list instead: the decision models for POST /v1/systemone as {"models": [{name, description, release_date}]}.
Query parameters
-
format string
Set to
openrouterto get OpenRouter's public model list from a client that does not send an OpenRouter SDK User-Agent, such as a browser (browsers cannot set it). Takes priority over the X-TypeSafe-SDK and Anthropic-Version headers. Other values are ignored.openrouter -
output_modalities string
Comma-separated output modalities to list:
text,image,embeddings,audio,video,rerank,decisions,speech,transcription, orall.audiois the music models, which generate through/v1/music. A model matches if any of its outputs is listed. Unset, the default catalog lists every model and OpenRouter's public list liststext, as OpenRouter's API does. Not applied in Anthropic or TypeSafe mode. -
input_modalities string
Comma-separated input modalities:
text,image,file,audio,video. A model matches if it accepts any of them. -
supported_parameters string
Comma-separated parameter names, as in the public model list's
supported_parameters. A model must support all of them. -
offset integer
OpenRouter public list only. Models to skip. Offset and limit both omitted is the whole list.
at least 0 -
after_id string
Anthropic mode only. Return the page after this model ID.
-
before_id string
Anthropic mode only. Return the page before this model ID.
-
limit integer
Anthropic mode: models per page, default 20. OpenRouter public list: models per page, default 500 once offset or limit is set.
default 20range 1–1000
Header parameters
-
anthropic-version string
When present, return Anthropic model entries and pagination fields instead of the default catalog.
-
X-Vultr-Model-Type string
Filter the default catalog to chat-completion models. Ignored in Anthropic mode.
chat -
X-TypeSafe-SDK string
Sent by TypeSafe's SDKs (for example
typesafe-sdk/0.7.2). When present, return TypeSafe's model list of decision models instead of the catalog.
Responses
OK
application/json
Unsupported model type filter, unknown output or input modality, invalid offset or limit, or invalid Anthropic pagination cursor. With anthropic-version the body is Anthropic's.
application/json
The model catalog is unavailable (OpenRouter public list only; the default catalog answers an empty list)
application/json · error-payload
curl https://api.vultrinference.com/v1/modelsimport requests
response = requests.get(
"https://api.vultrinference.com/v1/models",
)
print(response.json())const response = await fetch("https://api.vultrinference.com/v1/models");
console.log(await response.json());{
"data": [
{
"schema_version": "2.4",
"id": "string",
"name": "string",
"created": 0,
"description": "string",
"datacenters": [
{}
],
"input_modalities": [
{}
],
"output_modalities": [
{}
]
}
]
}