模型目录与模型 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 | 各供应商的报价与参数支持情况 |
pricing 与 providers 是价格的权威来源。 文档中不重复列出具体单价,以避免出现第二份会持续漂移的数据。
Gemini 形状
curl https://gateway.amux.ai/v1beta/models \
-H "x-goog-api-key: $AMUX_API_KEY"返回同一批模型,采用 Gemini 客户端期望的响应形状。
完整的字段定义与响应示例见 API 参考。