阿里云百炼 7000 万免费 Token 接入 WorkBuddy 前，先看清这 4 个容易踩坑的地方

WorkBuddy 内置模型积分不够用时，用阿里云百炼的免费额度来补充，是不少人在用的办法。百炼新用户开通后，系统会自动发放各模型的免费额度，合计超过 7000 万 Token，支持 OpenAI 兼容接口，可以接进 WorkBuddy 当自定义模型使用。

但“有额度”和“能正常用”之间，隔着几个很容易被忽略的细节。照着网上教程直接抄参数，轻则调用失败，重则产生意料之外的扣费。下面把这几个地方拆开说清楚。

一、7000 万不是一张通用余额，是“每个模型 100 万”的合计数

“超 7000 万免费 Token”听起来像一个大池子，实际上它是多个模型各自独立额度的总和。通常每个模型发放 100 万 Token，模型之间不能合并，也不能互相转移。某个模型的额度用完后，系统不会自动切换到另一个还有额度的模型。

有效期也不是从你第一次调用才开始算。免费额度的有效期是 90 天，计时起点取“开通百炼的时间”和“该模型发布或申请通过的时间”中较晚的那一个。到期后剩余额度直接失效，不补发、不延期，即使你一次都没用过，时间也照常走。

所以真正需要盯住的，不是“总数还有多少”，而是你准备用哪个模型、那个模型还剩多少、什么时候到期。开通后额度可能有短暂延迟，一般两小时内生效，刚开通看不到不必着急。

二、地域必须是“华北 2（北京）”，别的地域没有这份免费额度

免费额度只适用于华北 2（北京）地域的模型实时推理。如果你在其他地域创建业务空间或发起调用，账户里即使显示有新人权益，也可能无法抵扣。

免费额度覆盖的范围也有限。它只抵扣模型实时推理产生的 Token 消耗，Batch 调用、模型调优、模型部署、自定义模型、PAI-DSW、OSS 存储及请求费用，都不在免费额度覆盖范围内。

操作上很简单：开通后先进入百炼控制台，把页面顶部的地域切换到 华北 2（北京） ，再去模型广场确认目标模型是否显示免费额度条。不要看到 API Key 就直接往 WorkBuddy 里填，地域不对，后面全白搭。

三、接入 WorkBuddy 只需要 3 个参数，但 Base URL 必须用你自己的

百炼兼容 OpenAI 的 Chat Completions 协议。WorkBuddy 的自定义模型配置里，核心填三项：接口地址、API Key、模型名称。

接口地址不能直接抄别人的。华北 2（北京）按量付费的地址里包含你自己的 Workspace ID，格式是：

https://你的WorkspaceId.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions

注意结尾要写到 /chat/completions，WorkBuddy 不会自动补全。网上很多教程让所有读者照抄同一个 Base URL，这是最容易出问题的地方——别人的 Workspace ID 不是你的，接口地址写错，鉴权直接失败。

API Key 从你自己的百炼控制台创建。不要把 Key 发到聊天记录、公开文章或任何第三方对话里。

模型名称填百炼模型广场上显示的精确模型 ID，大小写要一致，不能把产品展示名或者中文名称直接当成模型 ID 填进去。

另外，百炼的普通按量付费、Token Plan、Coding Plan 使用的接口地址和密钥类型并不相同。想消耗新人免费额度，应当使用普通按量付费的 API Key 和对应的北京地域接口，不要把套餐专属密钥混进来。

四、在 WorkBuddy 里添加模型，不要碰配置文件

WorkBuddy 提供了可视化配置入口，不需要手动编辑 models.json，更不需要把 API Key 贴进对话让 AI 帮你改。

路径是：打开 WorkBuddy，左下角头像进入设置 → 模型 → 添加模型。提供商列表里有对应预设就优先选预设；没有就选“自定义 API”，填入前面准备好的接口地址、API Key 和模型名称，保存即可。

保存后，在对话界面的模型选择器里切换到刚添加的模型，先发一句简单问题测试连通。能正常聊天只说明基础接口通了，如果要用 WorkBuddy 跑 Agent 或工具调用任务，还需要确认这个模型本身支持工具调用，不要给模型勾选它不具备的能力。

最后一件事：把“免费额度用完即停”打开

这一点原文的说法需要修正。实际情况是：未完成实名认证的账号，该功能由系统强制开启，无法自行关闭；已完成实名认证的账号，“免费额度用完即停”默认是关闭的，需要你主动去控制台打开。很多人在实名认证后以为还在“免费模式”，额度耗尽后接口继续按量扣费，账单就是这么来的。

入口在百炼控制台的免费额度页面，找到目标模型，在操作列打开“免费额度用完即停”开关即可。打开这个开关，比反复盯余额要可靠得多。

现在可以按这个顺序做

① 开通百炼，把控制台地域切到 华北 2（北京） ；
② 在免费额度页面确认目标模型的独立额度和到期时间；
③ 创建自己的 API Key，复制含你自己 Workspace ID 的完整接口地址（写到 /chat/completions）；
④ 在百炼控制台打开“免费额度用完即停”；
⑤ 进入 WorkBuddy 设置 → 模型 → 添加自定义 API，填好三项参数，保存测试。

免费额度本身是实的，但能不能用上、用得安不安全，取决于地域、模型、接口地址和计费保护有没有一一对上。把这几个参数确认清楚，再接入 WorkBuddy，比直接抄教程要省事得多。