TraeWork
本文介绍如何在 TraeWork 中通过 OpenAI Chat Completions 和 Anthropic Messages 兼容协议接入胜算云 API 。
接入时需要准备 4 个关键信息：
- API 格式
- Base URL
- API Key
- 模型 ID
1. 下载安装
最新 TraeWork 下载地址：
请根据您的操作系统下载安装对应版本。
2. 基础配置步骤
安装并登录 TraeWork 后，按照以下步骤完成胜算云的接入配置。
打开模型设置
进入 TraeWork 主界面，单击左下角个人资料，打开 设置 页面
添加自定义模型
在设置页面中，切换到 模型 选项卡，点击 添加模型 按钮。
选择自定义配置
进入添加模型页面后，单击 自定义配置，打开自定义模型配置窗口。
设置 API 格式和请求地址
请根据您要使用的模型系列，选择对应的 API兼容格式 并填写对应的 自定义请求地址。beta-router 所有模型支持所有的 endpoint。
API格式 | 对应模型系列 | 自定义请求地址
（关闭「完整URL」开关） |
OpenAI Chat Completions 格式 | GPT系列、Gemini系列、DeepSeek系列、GLM系列、Grok系列 | |
Anthropic Messages 格式 | Claude系列 | https://beta-router.shengsuanyun.com/api |
提示：如果当前版本显示 完整URL 开关，请保持关闭。这里填写的是 Base URL，不是完整请求地址。
填写模型 ID
前往胜算云模型中心，找到需要使用的模型，点击对应模型旁的 复制 按钮：
👉 https://global.modelmesh.info/model
将复制的完整模型 ID 粘贴到 TRAE 的 模型 ID 中。下方的 模型展示名称 为选填项，可填写一个便于识别的名称。
提示：请完整复制模型 ID，保留供应商前缀和原有大小写，不要添加空格或自行修改。
获取并填写 API 密钥
前往胜算云个人控制台：
👉 https://console.shengsuanyun.com/user/keys
登录后创建并复制 API Key，将其粘贴到 TraeWork 的 API 密钥 中。
高级设置
若所选模型不支持图片输入，请展开 高级配置，将 支持图片输入 改为 不支持。例如，使用 deepseek/deepseek-v4-pro 时需要关闭该选项，否则连通性测试会失败。其他高级配置保持默认即可。如模型有特殊要求，请以模型说明为准。
点击添加模型
确认 API 格式、Base URL、模型 ID 和 API 密钥均填写正确后，点击右下角 添加模型 按钮。
TraeWork 会发起一次连通性测试，该测试会消耗少量模型 Token。测试通过并成功保存，说明配置已经生效。
切换至自定义模型
回到 TraeWork 对话页面，点击右下角下拉框，可直接选择刚刚添加的模型。
开始测试
输入一条简单消息。若模型正常返回内容，说明接入成功。
3. 常见问题
API Key 无效怎么办？
请确认：
- API Key 是否从胜算云控制台正确创建；
- 是否关闭了 完整URL 开关；
- 是否误填到了模型 ID 或其他字段；
如仍无法使用，可重新创建 API Key 后再试。
添加模型或连通性测试失败怎么办？
请重点检查：
- 检查两个 API 格式对应的 Base URL 是否填错；
- 如果错误信息包含
Please disable image input manually，请展开 高级配置，将 支持图片输入 改为 不支持，然后重新添加模型； - 模型 ID 是否从模型中心完整复制；
两种 API 格式应该如何选择？
根据您要使用的模型系列，选择对应的 API兼容格式 。两种格式使用不同的 Base URL，请勿混用协议和请求地址。
如何切换其他模型？
可以重复上述配置步骤添加多个模型，并在 TraeWork 对话页面的模型列表中随时切换。