如何查询 API Key 可用的模型列表（/v1/models）
每个 HRouter Key 能用哪些模型，由它所属的分组决定。调用前先请求一次 /v1/models，拿到准确的模型 ID，可以避免 model_not_found、404 这类最常见的错误。HRouter Desktop 的“识别 Key”做的就是同一件事。
用 curl 查询
curl https://hrouter.net/v1/models \
-H "Authorization: Bearer $HROUTER_API_KEY"
Windows PowerShell：
curl.exe https://hrouter.net/v1/models -H "Authorization: Bearer $env:HROUTER_API_KEY"
返回的 JSON 里，data 数组的每一项就是一个可用模型，id 字段是调用时要填的模型 ID：
{
"object": "list",
"data": [
{ "id": "模型 ID", "object": "model" }
]
}
只看模型 ID
装了 jq 的话：
curl -s https://hrouter.net/v1/models \
-H "Authorization: Bearer $HROUTER_API_KEY" | jq -r '.data[].id'
用 Python 查询
import os
from openai import OpenAI
client = OpenAI(base_url="https://hrouter.net/v1", api_key=os.environ["HROUTER_API_KEY"])
for model in client.models.list():
print(model.id)
怎么读这个列表
- 按前缀区分厂商：
claude-*是 Claude 模型，gpt-*是 OpenAI 模型，gemini-*是 Google 模型，grok-*是 Grok 模型。 - 列表因 Key 而异：同一个账号下，分组不同的 Key 返回的列表也不同。换了分组要重新查询。
- 复制准确 ID：区分大小写，不要用展示名称，也不要猜后缀。
- 列表为空或缺少想要的模型：这个 Key 的分组没有对应模型，见 如何选择 Key 分组。
价格在哪里看
模型的输入、输出和缓存价格在 模型页面 查看，可以按供应商、分组和计费方式筛选。实际扣费以 使用记录 为准。
常见问题
返回 401？ Key 不对或已停用，见 API 401 报错。
返回 404？
地址多写或少写了 /v1，见 404 路径错误。
列表里有模型，调用却失败？ 模型可见不代表客户端可用，分组可能有客户端限制，见 model_not_found 和 API 403 报错。