在 Trae 中添加和使用阿里云百炼的 API(比如 GLM-5.2),核心步骤就是获取 API Key 并在 Trae 中完成配置。整个过程很直接,主要有两种方式,你可以根据自己的情况选择。
阿里云百炼 API Key:https://bailian.console.aliyun.com
阿里云百炼Token Plan: https://www.aliyun.com/benefit/scene/tokenplan
Token Plan 概述产品帮助文档: https://help.aliyun.com/zh/model-studio/token-plan-overview
阿里云百炼控制台模型广场: https://bailian.console.aliyun.com
🎯 准备工作:获取阿里云百炼 API Key
无论选择哪种方式,都需要先准备好 API Key。
-
开通服务:确保你已注册阿里云账号并开通了百炼服务。首次开通通常会有免费额度。
-
获取API Key:访问你提供的链接(阿里云百炼API Key管理页面),或者通过控制台进入“密钥管理” > “API Key”页面。
-
点击“创建API Key”,生成后务必立即复制并妥善保存,因为页面关闭后无法再次查看完整密钥。
-
⚙️ 方法一:在Trae界面中直接添加(推荐)
这是最直观的方法,适合在 Trae IDE 的图形界面中操作。
-
打开设置:在 Trae 中,找到并进入“设置”或“偏好设置”(通常通过菜单栏或快捷键
Ctrl+,)。 -
进入模型管理:在设置页面中,找到“模型”或“AI设置”相关的面板。
-
添加模型:点击“添加模型”(Add Model)按钮。
-
选择配置方式:
-
方式A:选择预设服务商:如果列表中有“阿里云”,直接选择它,然后按提示填入你的 API Key 和想用的模型 ID(例如
glm-5.2)即可。 -
方式B:自定义配置:如果列表中没有阿里云,或想更灵活地配置,可以选择“自定义配置”(Custom Configuration)。
-
-
填写关键信息(针对自定义配置):
-
API 格式:选择 OpenAI Chat Completions,因为百炼的API兼容OpenAI格式。
-
请求地址 (Base URL / 完整URL):这是关键点。你需要填入百炼提供的API地址。根据你是否订阅了 Coding Plan,地址会有所不同:
-
如果你购买了 Coding Plan:请使用专属地址
https://coding.dashscope.aliyuncs.com/v1。并且要使用以sk-sp-开头的Coding Plan专属API Key。 -
如果你使用按量付费或免费额度:请使用标准地址
https://dashscope.aliyuncs.com/compatible-mode/v1。
-
-
模型 ID:填入你想要调用的精确模型名称,例如
glm-5.2。注意,模型名称必须完全匹配。 -
API 密钥:填入你在百炼控制台获取的 API Key。
-
-
保存并测试:点击保存,Trae通常会尝试连接测试。成功后,你就可以在对话窗口的模型列表中找到并切换到刚添加的自定义模型了。
⌨️ 方法二:通过配置文件添加(适用于CLI或批量配置)
如果你更习惯使用命令行或需要一次性添加多个模型,可以通过编辑 Trae 的配置文件 trae_cli.yaml 来实现。
-
使用命令
traecli config edit打开配置文件。 -
在
models:部分下,按照以下格式添加你的自定义模型配置:
models: - name: "我的GLM-5.2" # 在Trae中显示的模型名称 open_ai: base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1" # 或你的Coding Plan专属地址 api_key: "你的API_Key" model: "glm-5.2"
-
保存文件后,配置即生效。
📌 注意事项
-
API Key 类型要匹配:普通API Key(通常以
sk-开头)和Coding Plan专属API Key(以sk-sp-开头)不能混用,必须和对应的请求地址(Base URL)匹配。 -
模型名称要精确:填写的模型ID(如
glm-5.2)必须和百炼平台支持的名称完全一致,包括大小写和版本号。 -
网络与地域:确保你的网络环境可以访问百炼的API地址(
dashscope.aliyuncs.com)。百炼服务目前主要部署在华北2(北京)等地,但这不影响API的调用。
完成以上配置后,你就可以在 Trae 中流畅地使用 GLM-5.2 等模型,告别排队等待了。
轻量云Cloud