Amux AI

List Models

最近更新：2026年8月26日

返回本站当前可调用的模型，使用 OpenAI 的响应形状，并补充实用扩展字段。

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

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

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。

响应

200response

当前可调用的模型；带上有效密钥时收窄为这把密钥调得动的那些。除 OpenAI 标准字段外，每项还带 Amux 扩展字段（如 display_name、aliases、pricing、providers）。

401response

密钥缺失或无效。

带上密钥会看到什么

这条端点不要求鉴权——改完 base_url 先打一下它，是接入的第一步。

带上一把有效的密钥时，返回的是这把密钥调得动的那些模型：模型白名单、货源范围、指定供应商三项配置都会在这里生效，每个模型下的 providers[] 也只列它够得着的那几家，pricing 随之按剩下的那几家重算。同时报价按你的账户折扣计算。

密钥无效、过期或已停用都不会报错，按未鉴权处理、返回全部模型。所以这条端点不能当作权限校验用——真正的放行判定发生在调用那一刻。

扩展字段

除标准字段外，每一项还会补充以下扩展字段。这些字段不属于 OpenAI 官方协议；SDK 通常会忽略它们，但直接通过 HTTP 调用时可以读取。

字段说明
display_name展示名
context_length上下文窗口 token 数
max_output单次最大输出 token 数
input_modalities / output_modalities支持的输入 / 输出模态
capabilities能力开关（推理、视觉、工具、结构化输出等）
aliases除 id 之外还能调到这个模型的名字
pricing各计费组件的单价，每条自带单位与币种
providers提供这个模型的供应商，含各自的报价与参数支持

pricing 报的是折后起步价，促销期间即为促销价。真正按哪家供应商计费，要看 providers[] 里那一家的报价。每条价自带单位：per_request 按次计，input_text 按 token 计，两者差着六个数量级，换算前先看单位。

同一路径的三种响应形状

/v1/models 由三种兼容协议共用。响应形状取决于请求所使用的鉴权头：

鉴权头响应形状
Authorization: BearerOpenAI（本页）
x-api-key 且 anthropic-versionAnthropic
x-goog-api-key 或 ?key=Gemini

Gemini 另有独立地址 /v1beta/models，见列出模型（Gemini）。

各官方 SDK 会自动发送对应的鉴权头，因此大多数场景下无需额外处理。

cURL
curl https://gateway.amux.ai/v1/models \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-opus-5",
      "object": "model",
      "created": 1786000000,
      "owned_by": "anthropic",
      "display_name": "Claude Opus 5",
      "context_length": 200000,
      "max_output": 64000,
      "input_modalities": [
        "text"
      ],
      "output_modalities": [
        "text"
      ],
      "capabilities": {},
      "aliases": [
        "<string>"
      ],
      "pricing": {},
      "providers": [
        {}
      ]
    }
  ]
}