Amux

List Models

最近更新:2026年8月26日

返回本站当前可调用的全部模型,使用 Gemini 的响应形状,并补充少量实用扩展字段。

返回本站当前可调用的全部模型,使用 Gemini 的响应形状。Gemini SDK 的列模型调用可直接对接到这条端点。

GEThttps://gateway.amux.ai/v1beta/models

鉴权

header
Authorizationstring必填

控制台创建的 Amux 密钥。这是 Gemini SDK 原生发送的鉴权头; Authorization: Bearer 与 URL 上的 ?key= 同样接受。

请求

pageSizeinteger

Gemini 官方列表接口的分页大小。不支持——这里始终一次返回全部当前可调用模型。

pageTokenstring

Gemini 官方列表接口的分页游标。不支持——这里不分页,因此也没有后续页可取。

响应

200response

返回全部当前可调用模型,Gemini 形状。namemodels/ 前缀,可直接拼下一跳的地址; 本端点不分页,因此也不返回 nextPageToken

401response

密钥缺失或无效。

返回的是 Gemini 形状

{ "name": "models/anthropic/claude-opus-5", "baseModelId": "anthropic/claude-opus-5" }

namemodels/ 前缀,可直接拼成下一跳的地址({name}:generateContent)。要模型 ID 本身用 baseModelId

这一页返回的是完整列表,不分页,因此也不返回官方列表接口里的 nextPageToken

和另外两家的主要差别

OpenAI / AnthropicGemini
顶层数组datamodels
字段风格snake_casecamelCase
上下文窗口context_length / max_input_tokensinputTokenLimit
单次最大输出max_output / max_tokensoutputTokenLimit

supportedGenerationMethods 固定为 ["generateContent", "streamGenerateContent"]。是否流式在请求时决定,不是模型属性。

不返回 description 字段。模型简介是多语言的,按语言取用请查模型详情页

和 Gemini 官方列表接口的区别

pageSizepageToken 这两个官方查询参数在这里不支持。这条端点始终一次返回全部当前可调用模型,因此也没有分页游标可继续翻页。

扩展字段

thinkingaliasespricingproviders 都不是 Gemini 官方字段。Gemini SDK 会忽略它们;如果你是按 HTTP 直接调用,可以把它们当作补充信息来读。

  • thinking:布尔值,表示该模型当前是否带推理能力。
  • aliasespricingproviders:含义与 OpenAI 形状那页一致。

错误

错误按 Gemini 的错误体形状返回,见错误与重试

cURL
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": [
        {}
      ]
    }
  ]
}