Skip to content

List models

Returns the Public Free Model APIs catalog, with the pricing and capability metadata for each entry. A dedicated endpoint serves only the model you launched it with, and answers this path from vLLM or SGLang instead — see Dedicated endpoints.

GET /v1/models Bearer key or session

Also reachable at /api/v1/models.

No parameters.

Terminal window
curl https://developer.amd.com.cn/radeon/api/v1/models \
-H "Authorization: Bearer $RADEON_API_KEY"

The envelope is a bare { "data": [...] }. There is no object field, and entries carry richer metadata than OpenAI’s model object does — no owned_by, no created.

{
"data": [
{
"id": "DeepSeek-V4-Flash",
"name": "DeepSeek-V4-Flash",
"aliases": [],
"description": "Radeon DeepSeek V4 Flash served by the AMD GPU Cloud",
"family": "deepseek",
"architecture": {
"input_modalities": ["text"],
"output_modalities": ["text"],
"tokenizer": "GPT"
},
"top_provider": { "is_moderated": true },
"providers": [
{
"providerId": "radeon-deepseek",
"externalId": "DeepSeek-V4-Flash",
"pricing": {
"prompt": "0.00000014",
"completion": "0.00000028",
"input_cache_read": "0.0000000028"
},
"streaming": true,
"vision": false,
"tools": true,
"reasoning": true,
"stability": "stable"
}
],
"pricing": {
"prompt": "0.00000014",
"completion": "0.00000028",
"input_cache_read": "0.0000000028"
},
"context_length": 1048576,
"supported_parameters": [
"temperature", "max_tokens", "top_p",
"frequency_penalty", "presence_penalty",
"stream", "response_format", "tools"
],
"json_output": true,
"structured_outputs": true,
"free": true,
"stability": "stable"
}
]
}

Use any id from this list as the model field in chat completions.

FieldDescription
idThe name to send as model.
name, description, family, aliasesDisplay metadata.
architectureInput and output modalities, and the tokenizer family.
providersThe backends serving this model, each with its own pricing and capability flags.
pricingUSD per token, as decimal strings — prompt, completion, and input_cache_read where prompt caching applies.
context_lengthMaximum context window in tokens.
supported_parametersRequest parameters this model accepts. The full schema is under chat completions.
json_output, structured_outputsWhether response_format is honoured.
freeWhether calls are billed against your daily allowance at zero cost.
stabilitystable, beta, unstable, or experimental.

The catalog changes. Models are added and retired over time, so resolve the list at runtime rather than hard-coding names, and handle the case where a model you used yesterday has gone.

The catalog is the same for every key — it is not scoped to your account.

This endpoint doesn’t count against your concurrency allowance, though the per-minute rate limit still applies. It’s cheap to call, but cache the result for a few minutes rather than calling it before every completion.

The same metadata is rendered on each model’s card in the Token Factory.