List Models
最近更新:2026年8月26日
返回本站当前可调用的全部模型,使用 Gemini 的响应形状,并补充少量实用扩展字段。
返回本站当前可调用的全部模型,使用 Gemini 的响应形状。Gemini SDK 的列模型调用可直接对接到这条端点。
https://gateway.amux.ai/v1beta/models鉴权
headerAuthorizationstring必填控制台创建的 Amux 密钥。这是 Gemini SDK 原生发送的鉴权头; Authorization: Bearer 与 URL 上的 ?key= 同样接受。
请求
pageSizeintegerGemini 官方列表接口的分页大小。不支持——这里始终一次返回全部当前可调用模型。
pageTokenstringGemini 官方列表接口的分页游标。不支持——这里不分页,因此也没有后续页可取。
响应
200response返回全部当前可调用模型,Gemini 形状。name 带 models/ 前缀,可直接拼下一跳的地址; 本端点不分页,因此也不返回 nextPageToken。
401response密钥缺失或无效。
返回的是 Gemini 形状
{ "name": "models/anthropic/claude-opus-5", "baseModelId": "anthropic/claude-opus-5" }name 带 models/ 前缀,可直接拼成下一跳的地址({name}:generateContent)。要模型 ID 本身用 baseModelId。
这一页返回的是完整列表,不分页,因此也不返回官方列表接口里的 nextPageToken。
和另外两家的主要差别
| OpenAI / Anthropic | Gemini | |
|---|---|---|
| 顶层数组 | data | models |
| 字段风格 | snake_case | camelCase |
| 上下文窗口 | context_length / max_input_tokens | inputTokenLimit |
| 单次最大输出 | max_output / max_tokens | outputTokenLimit |
supportedGenerationMethods 固定为 ["generateContent", "streamGenerateContent"]。是否流式在请求时决定,不是模型属性。
不返回 description 字段。模型简介是多语言的,按语言取用请查模型详情页。
和 Gemini 官方列表接口的区别
pageSize、pageToken 这两个官方查询参数在这里不支持。这条端点始终一次返回全部当前可调用模型,因此也没有分页游标可继续翻页。
扩展字段
thinking、aliases、pricing、providers 都不是 Gemini 官方字段。Gemini SDK 会忽略它们;如果你是按 HTTP 直接调用,可以把它们当作补充信息来读。
thinking:布尔值,表示该模型当前是否带推理能力。aliases、pricing、providers:含义与 OpenAI 形状那页一致。
错误
错误按 Gemini 的错误体形状返回,见错误与重试。
curl https://gateway.amux.ai/v1beta/models \
-H "x-goog-api-key: $AMUX_API_KEY"{
"models": [
{
"name": "models/google/gemini-3-pro",
"baseModelId": "google/gemini-3-pro",
"displayName": "Gemini 3 Pro",
"inputTokenLimit": 1048576,
"outputTokenLimit": 65536,
"supportedGenerationMethods": [
"generateContent"
],
"thinking": false,
"aliases": [
"<string>"
],
"pricing": {},
"providers": [
{}
]
}
]
}