文档导航
INTEGRATION GUIDE

Trae 接入指南:自定义协议、完整 URL 与企业限制

按 TraeCode 中国版官方模型文档核对自定义端点,区分基础地址和完整请求 URL,说明个人与企业模型权限及协议范围,不外推到所有 TRAE 客户端。

内容复核中 官方配置已核对;本站接入未实测。 图解为本站原创示意,不是客户端运行截图。

查看教程占位服务地址
控制台
https://80321.cn
创建 Key
https://80321.cn/keys
钱包充值
https://80321.cn/wallet
文档站
https://80321.cn/docs.html

以上服务地址仅为教程占位示例,不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。

本页目录

Trae 原创配置示意,非运行截图

明确 TraeCode 和账号范围

Trae 是产品家族名称。本篇核验的是中国版官方 TraeCode 模型文档,而不是把 TraeWork、国际版或 CLI 的菜单合并成同一套操作。当前文档支持预设服务商与自定义配置两类入口。 开始前记下客户端版本、地区版本和个人或企业账号类型。

若企业账号看不到添加入口,先向管理员核对成员自定义模型权限。企业文档把模型可见范围、启用状态和成员自行添加权限分别管理。 在个人电脑改设置不能替代组织授权。

选择格式与请求地址

前往设置中的模型面板,点击添加模型,再选择自定义模型。个人版文档列出 OpenAI Chat Completions 与 Anthropic Messages;企业模型页另外列有 Responses,不能把企业说明直接当作所有版本的能力。

以下是原创占位示意,并无真实接口、真实 Key 或可用模型,也不代表本站提供 API:

项目 示例
API 格式 OpenAI Chat Completions
完整 URL 关闭时 https://80321.cn/v1
完整 URL 开启时 https://80321.cn/v1/chat/completions
API 密钥 YOUR_API_KEY
模型 ID YOUR_MODEL_ID

两个地址是不同填写方式,不要同时叠加。官方说明关闭完整 URL 后,客户端按协议拼接路径;开启后应填写完整请求地址。

让模型名称与能力对应

模型展示名可以自行命名,模型 ID 必须与服务端一致。先保留少量已确认的高级设置,不要为了让模型出现在列表而假报图片或推理能力。官方明确指出图片输入仍需要模型本身支持,自定义上下文等参数也会影响客户端配置。

提交配置会触发服务接口检测,随后再在对话模型列表中选中新模型。 首次验证只使用一段无敏感内容的文本,文本成功以后才检查 Agent 工具调用,不用生产仓库测试。

按日志定位接入失败

地址错误先比较最终路径,避免重复追加版本前缀或漏掉接口后缀。鉴权失败则核对凭证是否属于当前服务、是否有选定模型权限。模型保存但不可见时,检查是否被禁用、企业可见范围以及本地选择列表;不要用反复更换随机模型 ID 的方式试探权限。

记录脱敏错误信息即可,不公开上传服务商返回的完整日志。普通聊天成功不等于长上下文、多模态和工具循环全部通过。

核对数据接收方与组织设置

在批准使用外部端点前,明确代码片段、工具输出与附件由谁接收,分别核对模型服务和客户端的数据政策。企业文档还提供在模型请求头传递成员邮箱的选项,启用前应评估必要性与访问范围。 本文没有访问真实账号或执行接口检测,结论仅为官方配置路径已核验。