自定义模型短聊天
复现：在当前 TRAE 版本添加模型，选中后新建会话，只问“2+2 等于几”。
通过：能读到非空回答；平台日志里的端点与 API 格式一致。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
TRAE 选择 API 格式后再决定请求地址。打开“完整 URL”时，OpenAI Chat 填 https://api.apizt.com/v1/chat/completions；Anthropic Messages 填 https://api.apizt.com/v1/messages。关闭时由客户端拼接路径，应按版本核对最终 URL。
适合在 TRAE 自定义模型里完成对话和 Builder 编程任务。模型保存、短对话、Builder 工具调用要分别验收。
按真实任务判断是否可用
Builder 代码任务
复现：在测试仓库让 Builder 读取 README，并概括项目用途。
通过：工具返回文件内容且最终回答引用真实文件；短对话成功本身不算通过。
先选对协议和请求地址
“完整 URL”开关开启：填完整 Chat 或 Messages 请求地址；关闭：填当前版本要求的基础地址，由客户端拼接。API 格式决定请求与响应结构，模型品牌不能替代协议选择。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
入口：设置 → 模型 → 添加模型 → 自定义模型
Chat：OpenAI Chat Completions + 完整 URL 开启
地址：https://api.apizt.com/v1/chat/completions
或 Messages：Anthropic Messages + 完整 URL 开启
地址：https://api.apizt.com/v1/messages
Key / 模型 ID：使用平台当前授权值这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 TRAE 自定义模型 配置与验证清单照这个顺序接入
- 01
记录版本和开关
TRAE 国内版、国际版和发行版本可能有不同入口。确认当前界面能设置 API 格式与完整 URL 开关。
- 02
成对配置格式与路径
Chat 使用 Chat 路径，Messages 使用 Messages 路径；打开完整 URL 时不要只填 /v1。保存后检查请求实际路径。
- 03
先文本后 Builder
短回答有效后，再用小型测试仓库验证读文件；遇到 empty content 要看响应体和流式结束事件。
对照工具配置与验证顺序
验证到哪一步？
现有教程保存 Python requests 2.33.1 对 Chat 和 Messages 的 HTTP 200 记录；官方文档确认完整 URL 开关行为。
- 现有依据
- 独立 API 请求已成功，TRAE 客户端待测
- 验证边界
- 本机未安装 TRAE，不能把 Python API 请求记作 TRAE 聊天或 Builder 成功。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| 404 或 path not found | 开关状态与填写的 URL 类型不一致。 | 记录开关、API 格式、最终路径，再比对这三项。 |
| HTTP 200 但 empty content | 所选 API 格式的响应结构或流式事件与客户端预期不同。 | 先比对非流式最小请求，再检查 TRAE 的错误详情。 |
| 聊天通过，Builder 失败 | 工具调用、长上下文或运行环境权限未验证。 | 用只读测试文件复现首个工具调用，保留脱敏错误。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
确认最终 URL 与选定 API 格式一致，返回有效文本且平台有对应日志；再验证一个最小工具任务。
查看 TRAE 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
Trae model request failed 完整 URL 开关怎么检查？
开关开启时填写所选协议的完整端点，关闭时按客户端规则填写可拼接的地址。查看实际请求，避免重复追加 /chat/completions 或将 Messages 路径用于 Chat。
Trae 模型请求失败为什么不能直接复制其他工具 Base URL？
不同字段可能需要根地址或完整 URL，且协议不同。先核对 Trae 当前版本和所选 API 格式，再组合匹配的 Key、路径与准确模型 ID。
TRAE 应该填写哪个 API 地址？
打开“完整 URL”时，Chat Completions 填 https://api.apizt.com/v1/chat/completions；Messages 填 https://api.apizt.com/v1/messages。关闭时由客户端拼接，必须检查最终路径。
终端请求成功，为什么客户端仍然失败？
完整 URL 开启时填写 /v1 会请求到错误位置；关闭时粘贴完整端点可能造成路径重复。 模型校验成功不证明 Builder、工具调用和长上下文都可用；逐项测试需要的功能。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。