Amux

模型目录与模型 ID

最近更新:2026年9月15日

模型 ID 的格式与别名规则、模型目录上各字段的含义,以及如何以编程方式获取可调用的模型清单。

模型目录列出平台当前提供的全部模型。每个模型下列出提供该模型的所有供应商及其报价——模型是能力单位,供应商是提供该能力的实体,两者的关系见供应商与货源层级

模型 ID

调用时 model 字段使用规范 ID,格式为 厂商/模型

anthropic/claude-opus-5
openai/gpt-5.6
deepseek/deepseek-v3.2

规范 ID 在模型详情页给出,也可通过 GET /v1/models 获取。

别名

平台为常见模型维护别名,便于从其他环境迁移时直接复用既有代码。裸名(如 claude-haiku-4-5-20251001)通常可以直接使用。

别名在全站唯一:同一个名字不会同时指向两个模型。因此不存在解析歧义,也不需要「先试完整 ID、再试裸名」的回退逻辑。

新接入建议始终使用规范 ID。别名是迁移期的便利,而规范 ID 明确表达了厂商归属。

名称本身包含冒号的情况

冒号在模型 ID 之后用作后缀分隔符(模型:供应商模型:@策略),而部分模型的名称本身就带冒号,例如 llama3.1:70b 或 Bedrock 风格的 ...-v2:0

解析时先以完整字符串查询一次别名表,命中即视为完整模型名;未命中才按最后一个冒号拆分。因此这类名称可直接使用,无需转义。

目录上的字段

字段含义
类型对话、图像、视频、音频、向量、重排
输入模态可以接收哪些类型的输入:文本、图片、音频、视频、文件
输出模态会产出哪些类型的输出
上下文长度上下文窗口的 token 数。各供应商可能不同,以该供应商一行为准
最大输出单次调用的最大输出 token 数
发布时间模型的发布日期
支持的协议该模型可通过哪些协议调用

能力

能力含义
流式输出支持增量返回
工具调用支持函数 / 工具调用
推理具备独立的思考过程,思考 token 可能单独计价
结构化输出支持约束输出为指定的 JSON Schema
提示缓存支持提示词缓存,缓存读写单独计价
视觉可以接收图片输入

能力标记描述的是模型本身。某项能力经由某个具体协议调用时是否可达,以及跨协议调用时参数如何映射,见协议转换参数兼容性

状态

状态含义
已上线正常可调用
即将推出已公布但尚未发布。目录中可见并带标识,不可调用,不展示价格与供应商
已弃用仍可调用,但厂商已宣布下线计划
已下线不再可调用

「已弃用」用于提前给出迁移信号,建议在该状态出现后即安排切换,不要等到不可调用。

浏览与筛选

目录支持按名称或 ID 搜索,并可按以下维度筛选:厂商、供应商、输入模态、输出模态、上下文长度、支持的协议。排序支持最新发布、价格从低到高、上下文从大到小与按名称排列。

  • 厂商页/models/<厂商>)列出该厂商的全部模型
  • 供应商页/provider/<供应商>)列出该供应商提供的全部模型
  • 模型对比 可将多个「模型 × 供应商」并排比较价格、上下文、表现指标、端点与能力

模型详情页还提供该模型在各供应商上的表现指标与用量趋势,口径见供应商与货源层级

以编程方式获取模型清单

OpenAI 形状

curl https://gateway.amux.ai/v1/models \
  -H "Authorization: Bearer $AMUX_API_KEY"

不带密钥时返回站内全部可调用模型;带上有效密钥时,只返回这把密钥调得动的那些——即已经应用了该密钥的模型白名单、货源范围与指定供应商约束。这是确认「这把密钥到底能调什么」最直接的方式。

除 OpenAI 标准字段外,每一项还带以下扩展字段:

字段含义
display_name展示用名称
context_length / max_output上下文窗口与最大输出 token 数
input_modalities / output_modalities输入与输出模态
capabilities能力开关
aliases该模型的全部别名
pricing各计费项的起步价
providers各供应商的报价与参数支持情况

pricingproviders 是价格的权威来源。 文档中不重复列出具体单价,以避免出现第二份会持续漂移的数据。

Gemini 形状

curl https://gateway.amux.ai/v1beta/models \
  -H "x-goog-api-key: $AMUX_API_KEY"

返回同一批模型,采用 Gemini 客户端期望的响应形状。

完整的字段定义与响应示例见 API 参考

相关