聚合站支持哪些模型:与 OpenRouter 的模型清单逐家对照
本文教你如何从聚合站官方文档获取准确的模型清单,并与 OpenRouter 的公开模型列表进行对照,避免因猜测模型名称而导致的调用错误。
为什么要对照模型清单
很多开发者习惯根据记忆或网上的示例代码直接填写模型名称(如 claude-3-opus、gpt-4),但不同聚合站的模型标识可能不同。错误的名字会导致 API 返回 model not found。
因此,第一步永远是:先阅读你正在使用的聚合站的官方文档,找到它支持的模型清单。
如何获取聚合站自家的模型清单
- 登录聚合站控制台,进入「模型列表」或「可用模型」页面。
- 有些聚合站会通过 API 端点暴露模型列表,例如
GET /v1/models(取决于站点实现)。 - 官方文档通常按厂商分组列出模型,例如:
- Claude 系列
- GPT 系列
- DeepSeek 系列
- Qwen 系列
- GLM 系列
- Kimi 系列
关键点:清单中每个模型都有一个唯一的模型 ID,这个 ID 才是你调用时 model 参数应该填写的值。不要自行拼接或猜测。
为什么还要和 OpenRouter 对照
OpenRouter 是一个公开的模型聚合平台,它的模型列表可以作为命名参考。很多聚合站会沿用与 OpenRouter 相同或相似的模型 ID,以降低用户迁移成本。
对照的目的:
- 确认同一厂商的模型在不同平台上的 ID 是否一致。
- 发现聚合站是否对某些模型使用了自定义名称(如添加前缀、后缀)。
- 避免把 OpenRouter 的模型 ID 直接复制到其他聚合站而未经检查。
具体对照步骤
- 打开聚合站的模型清单页面,记录你需要的所有模型 ID。
- 访问 OpenRouter 的模型列表页面(通常是
openrouter.ai/models)。 - 按厂商逐家比对:
- 找到同一厂商(如 Anthropic、OpenAI、DeepSeek 等)。
- 对比模型名称和版本号。
- 注意聚合站是否添加了额外标识(例如
-beta、-preview)。
- 如果发现不一致,以聚合站文档为准,因为最终调用的是该站的 API。
- 如果聚合站文档没有列出某个模型,但 OpenRouter 有,不要假设聚合站也支持。
常见坑与注意事项
- 模型名称大小写敏感:
GPT-4和gpt-4可能不同。 - 版本别名:如
claude-3-sonnet可能指向最新版,也可能固定指向某个日期版本。以文档说明为准。 - 别名与快照:有些站提供
latest别名,但行为可能变化。生产环境建议使用固定版本。 - 不要使用 OpenRouter 的专属模型 ID:OpenRouter 可能有一些独有的路由标识(如
openrouter/auto),这些在其他聚合站通常不可用。 - 定期检查更新:模型清单会变化,建议每隔一段时间重新对照一次。
总结
- 始终以聚合站官方文档中的模型 ID 为准。
- 用 OpenRouter 的清单作为交叉参考,帮助理解命名规律。
- 不要凭猜测填写模型名,也不要把一个平台的 ID 直接复制到另一个平台。
- 遇到不一致时,优先信任你正在调用的聚合站。