作者注:新模型扎堆发布时,先查型号是否在架,在架的只改模型 ID,换之前核对价格、端点和分组。用同一把密钥就能完成测试,不必为每家厂商再开一个账号。
2026-11-09,Anthropic 发布了 Claude Fable 5.2。一周后的 2026-11-16,阿里云把 Qwen4-Max 记入模型上架列表。对要接新模型的应用开发者来说,难点通常不在调用代码,而在流程:每出一家新模型,就要注册账号、申请密钥、绑定支付、再改一遍配置。本文介绍 一把密钥换模型 ID 的三步测法,帮你用同一套调用先测已经在架的型号。
这不是又一篇发布会复述。文中的型号和价格以 API易 apiyi.com 型号总表(页面注明数据更新于 2026-11-16 09:39,UTC+8,来源为系统实时定价接口)和厂商文档为准。我们不给出自测跑分,只讲测之前该查什么、该改什么、该对什么。
核心价值:读完本文,你能用一个环境变量里的同一把密钥,在 claude-fable-5-2 和千问系列之间切换测试,并在切换前核对清楚这次换模型会怎样影响账单。

新模型怎么测:一把密钥换模型 ID 的核心要点
新模型扎堆时,最容易出错的不是代码,而是没确认“这个型号到底能不能调、按什么价调”就把 model 改了。下表是三步测法的骨架,后面逐条展开。
| 步骤 | 做什么 | 为什么 |
|---|---|---|
| ① 查总表和定价接口 | 在型号总表和定价接口里搜目标模型 ID | 先确认在不在架,价格以这一行为准 |
| ② 在架的只改 model | 保持 base_url 和密钥不变,只替换 model 字段 |
同一套调用即可覆盖多家模型 |
| ③ 对分组、端点、缓存读 | 核对输入价、输出价、缓存读、端点和分组 | 换模型会改账单,也可能改调用协议 |
一把密钥换模型 ID 为什么成立
API易的令牌文档写明:令牌不设模型白名单时,可用全站 200+ 精选模型;设了白名单,就只能调用指定的模型。所以“一把密钥换模型”有个前提:你用的令牌没有把目标模型挡在白名单之外。如果你习惯按项目隔离,文档也支持为不同项目建独立令牌,分别查看额度、有效期和日志。
另一个容易忽略的概念是分组。文档的解释是:分组是资源通道,不同模型可能需要不同分组;一个令牌最多配置 1 个默认分组和 2 个兜底分组,不确定时用 Default。这意味着换模型 ID 之后能不能调通,除了看型号是否在架,还要看它所在的分组是否覆盖了你令牌的分组设置。

新模型怎么测第一步:查型号总表和定价接口
动手改代码前,先做两次查询:一是型号总表 docs.apiyi.com/models.md,二是定价接口 https://api.apiyi.com/api/pricing。总表方便人工浏览和比价,定价接口适合写进脚本,在 CI 或配置中心里自动校验“这个 model 在不在价目里”。两处结论一致,再进入下一步。
以本周的两个新模型为例,查询结果差别很大:
| 模型 ID | 厂商发布情况 | API易型号总表 | 2026-11-17 定价接口 | 测试建议 |
|---|---|---|---|---|
claude-fable-5-2 |
Anthropic 2026-11-09 公告 | 在架(另有 claude-fable-5-2-thinking) |
有 | 直接改 model 测 |
qwen4-max |
阿里云 2026-11-16 记入上架 | 阿里巴巴一节中没有 | 返回中无 qwen4 | 先用邻近型号跑通链路 |
qwen3.8-max |
已有型号 | 在架 | 有 | 作为千问链路的替代测试对象 |
还要注意一个细节:claude-fable-5-2 在 API易文档里没有单独的型号说明页,对应地址会返回 404。因此它的价格只能以总表这一行为准,不要从别处拼凑。
🎯 技术建议:把“查定价接口”做成发版前的一步检查。配置里出现新的 model 字符串时,先用脚本请求 API易 apiyi.com 的定价接口确认它存在,可以避免上线后才收到“模型不存在”的报错。
Claude Fable 5.2 在架:直接改模型 ID 测
根据 Anthropic 2026-11-09 的公告,开发者模型 ID 为 claude-fable-5-2。公告称它的生成速度比 Fable 5.1 快最多 30%,官方价格为每百万 token 输入 $8、输出 $40。官方另有可选的 fast mode,价格为输入 $16、输出 $80。API易总表里没有 fast mode 这一行,所以不要按 fast mode 的预期去写配置。
同一公告还说明,Fable 与 Mythos 使用同一个底座:Fable 对所有用户开放,Mythos 则需要通过生命科学或网络安全的核验计划。Anthropic 模型总览中的当前型号为 Claude Fable 5.2、Claude Opus 5.5、Claude Sonnet 5.5、Claude Haiku 5.5,以及需要核验的 Mythos 5.2,并没有叫 Fable 5.5 的型号。公告的建议是:多数编码和知识任务先从 Claude Opus 5.5 开始,不够再上 Fable,任务更轻则用 Sonnet 5.5 或 Haiku 5.5。
在 API易,claude-fable-5-2 和 claude-fable-5-2-thinking 都是文本、按量计费,输入 $8、输出 $40、缓存读 $0.2(每百万 token)。端点同时支持 chat 与 messages,分组为 ClaudeCode、Claude_Enterprise、Default、SVIP。这组价格只适用于这两个 Fable 型号,不代表其他 Claude 型号的价格。
Qwen4-Max 怎么测:先用已上架的 qwen3.8-max 跑通千问链路
先看厂商侧的信息。阿里云型号页给出的调用 ID 是 qwen4-max:输入支持文本、图像、视频,输出为文本,上下文长度 1,000,000;最大输入 991,808、最大输出 131,072;思考模式下最大输入 983,616、最大输出 262,144、最大思维链 262,144。它支持工具调用、结构化输出、显式缓存和隐式缓存,兼容 OpenAI Chat Completions、Responses 与 Anthropic Messages,但不支持批量推理和模型调优。阿里云“模型上架与更新”页把它记在 2026-11-16,服务部署范围为中国内地。
价格要分来源、分币种看,不能合并成一个数。阿里云百炼型号页原文写的是人民币标价:非思考与思考同一档,中国内地和“全球”部署为每百万 token 输入 10 元、输出 30 元,国际部署为输入 10.938 元、输出 32.813 元。同一页还写有 100 万 token 免费额度,有效期从开通百炼、模型发布或申请通过之日起 90 天(以较晚者为准)。这是百炼的标价和百炼的额度,与 API易无关。Qwen 官方账号 2026-11-16 的帖子则自述了另一套美元价:输入 $1.5、输出 $4.5、隐式缓存 $0.075(每百万 token),并说明 API 在 QwenCloud 提供。在 API易,qwen4-max 暂未上架,我们会尽快上架这个模型;型号与价格以平台型号列表为准。
所以,千问这条线的做法是:先用总表里已有的 qwen3.8-max 把调用链路、提示词模板、解析逻辑和计费监控跑通。它在 API易的价格为输入 $1.65、输出 $4.95、缓存读 $0.20625(每百万 token),端点为 chat 与 messages,分组为 ClaudeCode、Default、SVIP。等 qwen4-max 出现在定价接口里,你要做的通常只是改 model,再按第三步重新核对一遍。
一把密钥换模型 ID 快速上手
下面用行内代码说明最小配置,全程只用一把密钥。
- 密钥放环境变量:例如
export APIYI_API_KEY=你的密钥。不要把密钥写进仓库,也不要提交到配置文件里。 - 客户端只初始化一次:Python 中可以写
client = OpenAI(api_key=os.environ["APIYI_API_KEY"], base_url="https://api.apiyi.com/v1"),对应的 Chat Completions 路径是/v1/chat/completions。 - 模型 ID 做成配置项:例如
MODEL=claude-fable-5-2,调用时写client.chat.completions.create(model=os.environ["MODEL"], messages=[...])。 - 切换测试只改一处:把
MODEL改成qwen3.8-max重跑同一组用例,base_url、密钥和消息结构都不动。 - 记录每次请求的 model 字段:日志里写清楚本次用的模型 ID,后面对账时可以按模型拆分费用。
这样做的好处是,对比测试的变量只剩模型本身。同一组提示词、同一套解析代码,换一个字符串就能看到不同模型的输出差异,也方便把结果直接放进你的评测表。
🚀 快速开始:如果还没有密钥,可以在 API易 apiyi.com 注册,新用户有免费测试额度。建议先建一个专门用于“新模型评测”的独立令牌,额度、有效期和日志都与生产环境分开。
换模型 ID 前第三步:对分组、端点和缓存读
改 model 字段很简单,但它可能悄悄改变两件事:账单和协议。下面这张清单建议在每次切换前过一遍:
| 核对项 | 看哪里 | 常见坑 |
|---|---|---|
| 输入价 / 输出价 | 型号总表对应行 | 同一家厂商不同型号价差很大,不能按“同系列”估算 |
| 缓存读价 | 总表缓存读列 | 长系统提示词场景下,缓存读价格直接影响成本 |
| 端点 | 总表端点列(chat / messages) | 代码走 /v1/chat/completions,就要确认该型号支持 chat |
| 分组 | 总表分组列 + 令牌分组设置 | 不同模型可能需要不同分组,不要默认都在 Default |
| 白名单 | 令牌设置 | 令牌设了白名单,新模型 ID 没加进去就会被拒 |
把这次的两个型号放在一起看,差异会更直观:

| 模型 ID | 价格来源 | 输入 | 输出 | 缓存读 | 端点 | 可用平台 |
|---|---|---|---|---|---|---|
claude-fable-5-2 |
API易总表 | $8 | $40 | $0.2 | chat、messages | API易 apiyi.com、Anthropic 官方 |
qwen3.8-max |
API易总表 | $1.65 | $4.95 | $0.20625 | chat、messages | API易 |
qwen4-max |
百炼型号页原文(内地 / 全球) | 10 元 | 30 元 | — | 厂商侧兼容多种协议 | 阿里云百炼 |
qwen4-max |
Qwen 官方帖自述 | $1.5 | $4.5 | 隐式缓存 $0.075 | — | QwenCloud |
表中价格单位均为每百万 token,美元价和人民币价分属不同来源,请分开理解,不要换算后相加或直接比较。分组同样要逐个核对:claude-fable-5-2 有 Claude_Enterprise 分组,qwen3.8-max 没有。如果你的令牌默认分组是 Claude_Enterprise,切到千问时就需要兜底分组里包含它所在的分组。
💡 选择建议:评测阶段建议把令牌默认分组设为 Default,并配置 1 到 2 个兜底分组,覆盖你要测试的型号。具体每个型号属于哪些分组,以 API易型号总表为准。
常见问题 FAQ
Q1:“一把密钥换模型 ID”具体指什么?
指 base_url、密钥和请求结构都保持不变,只替换 `model` 字段来切换模型。前提是目标型号已经在平台上架,令牌没有用白名单挡住它,并且所在分组可用。
Q2:qwen4-max 现在能直接测吗?
截至 2026-11-17,API易总表和定价接口里都查不到 `qwen4-max`。建议先用 `qwen3.8-max` 跑通千问链路,之后定期请求 API易 apiyi.com 的定价接口,确认它出现后再切换 model。
Q3:百炼的 100 万 token 免费额度能在 API易用吗?
不能。那是阿里云百炼型号页原文写的百炼额度,只在百炼生效。API易有自己的新用户免费测试额度,两者是两回事。
Q4:Claude Fable 5.2 的 fast mode 能通过 API易调用吗?
API易总表里没有 fast mode 这一行,在架的是 `claude-fable-5-2` 和 `claude-fable-5-2-thinking`。fast mode 的 $16 / $80 是 Anthropic 官方价格。
Q5:改了 model 之后报错,先查什么?
按顺序排查:型号是否在总表里、令牌白名单是否包含它、令牌的分组是否覆盖该型号的分组、端点是否支持你走的路径。如果自己判断不了,可以在 API易 apiyi.com 查看对应令牌的调用日志,定位是哪一项被拒。
Q6:能不能所有模型都只用 Default 分组?
不能这样假设。文档建议在不确定时用 Default,但也说明不同模型可能需要不同分组。每个型号的分组以总表为准,必要时配置兜底分组。
新模型怎么测:一把密钥换模型 ID 核心要点 Key Takeaways
- 先查再改:型号总表和定价接口都查到目标 ID,再动配置。
- 只改 model:已在架的型号,base_url 和密钥保持不变。
- Fable 价格单看:
claude-fable-5-2的 $8 / $40 / 缓存读 $0.2 不代表其他 Claude 型号。 - 千问先跑旧链路:用
qwen3.8-max验证流程,qwen4-max上架后再切换。 - 币种分开读:百炼人民币价和 Qwen 帖美元价来源不同,不要合并成一个数。
- 分组逐个对:令牌最多 1 个默认分组加 2 个兜底分组,不要默认都在 Default。
总结
新模型扎堆时,测试效率取决于流程,而不是开了多少个账号:
- 查总表与定价接口:确认型号在架,价格以总表那一行为准。
- 在架只改 model:同一把密钥、同一套调用,覆盖多家模型。
- 对分组、端点、缓存读:换模型会改账单,也可能改协议,切换前逐项核对。
这周的情况正好对应两种路径:claude-fable-5-2 可以直接测,千问则先用 qwen3.8-max 把链路跑通。推荐通过 API易 apiyi.com 用一把密钥完成这套测试,把精力留给评估模型本身。
📚 参考资料
-
API易型号总表:价格、端点、分组的核对依据
- 链接:
docs.apiyi.com/models.md - 说明:页面注明数据更新于 2026-11-16 09:39(UTC+8),来源为系统实时定价接口
- 链接:
-
API易令牌与分组说明:白名单、独立令牌、默认与兜底分组
- 链接:
docs.apiyi.com/faq/token-and-groups.md - 说明:解释“一把密钥换模型”的前提条件
- 链接:
-
Anthropic Claude Fable 与 Mythos 5.2 公告:模型 ID、官方价格与 fast mode
- 链接:
anthropic.com/claude-fable-and-mythos-5-2 - 说明:包含 Mythos 核验要求和选型建议
- 链接:
-
Anthropic 模型总览:当前 Claude 型号列表
- 链接:
platform.claude.com/docs/en/about-claude/models/overview - 说明:确认现有型号名称
- 链接:
-
阿里云百炼 Qwen4-Max 型号页:规格、人民币标价与百炼免费额度
- 链接:
help.aliyun.com/zh/model-studio/qwen4-max - 说明:价格和额度均为百炼文档原文
- 链接:
-
阿里云模型上架与更新:qwen4-max 上架日期与部署范围
- 链接:
help.aliyun.com/zh/model-studio/newly-released-models - 说明:记录时间为 2026-11-16
- 链接:
-
Qwen 官方博客与官方账号帖:美元价自述与 QwenCloud
- 链接:
qwen.ai/blog?id=qwen4-max - 说明:美元价格为官方自述,需与百炼人民币价分开看
- 链接:
作者:APIYI 技术团队
技术交流:欢迎在 API易官网首页联系我们,更多型号与分组说明请参阅文档中心。
