Amux AI

模型列表接口

最近更新：2026年10月29日

本平台提供的模型列表接口、响应格式，以及列表中模型名的格式。

返回当前可调用的模型。同一地址根据鉴权头返回 OpenAI、Anthropic 或 Gemini 格式。

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

鉴权

header
Authorizationstring必填

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

响应

200response

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

401response

密钥缺失或无效。

接口与响应格式

地址鉴权头响应格式详细说明
GET /v1/modelsAuthorization: BearerOpenAI列出模型（OpenAI）
GET /v1/modelsx-api-key 与 anthropic-versionAnthropic列出模型（Anthropic）
GET /v1/modelsx-goog-api-key 或 ?key=Gemini列出模型（Gemini）
GET /v1beta/modelsx-goog-api-key 或 ?key=Gemini同上

响应格式由鉴权头决定，无需更换地址。官方 SDK 会自动发送相应的鉴权头。

模型名

列表中的 id（Gemini 格式为 baseModelId）为裸名，即不带厂商前缀的模型名，例如 claude-opus-5。中转服务同步该列表后，可直接与其他上游的同名模型合并，无需逐个配置模型映射。

带厂商前缀的规范 ID（例如 anthropic/claude-opus-5）同样可用，见 canonical_id（Gemini 格式为 canonicalId）与 aliases。未设置裸名的模型，id 为规范 ID。

无论请求使用哪种名称，响应中的 model 字段均返回规范 ID。

鉴权

以上接口无需鉴权。携带有效密钥时，仅返回该密钥可调用的模型，价格按账户折扣计算；密钥无效时按未鉴权处理，返回全部模型。

cURL
curl https://gateway.amux.ai/v1/models \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "claude-opus-5",
      "canonical_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": [
        {}
      ]
    }
  ]
}