先看错误信息
API key failedTrae API key failed 检查普通 Key 字段的令牌格式、签发服务和当前状态，同时核对完整 URL 开关与 API 格式。保留验证返回的状态码，分清客户端格式校验与真实 HTTP 鉴权失败。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
确认最终 URL 与选定 API 格式一致，返回有效文本且平台有对应日志；再验证一个最小工具任务。
查看 TRAE 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
常见表现
- 保存自定义模型时校验失败
- 聊天前就提示 Key failed
- 后台没有请求记录
这个报错是什么意思
连接提示只是症状。先区分配置加载、模型列表、文字回答和工具调用发生在哪一步；TRAE 的检查重点是：model request failed、完整 URL 开关与空内容。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
打开“完整 URL”时，Chat Completions 填 https://api.apizt.com/v1/chat/completions；Messages 填 https://api.apizt.com/v1/messages。关闭时由客户端拼接，必须检查最终路径。
判断 02
完整 URL 开启时填写 /v1 会请求到错误位置；关闭时粘贴完整端点可能造成路径重复。
判断 03
模型校验成功不证明 Builder、工具调用和长上下文都可用；逐项测试需要的功能。
按顺序修复
01
确认正在使用的 TRAE 版本、国内或国际版本及自定义模型入口；记录“完整 URL”开关状态。
02
先按模型通道选择 OpenAI Chat Completions 或 Anthropic Messages，再配置对应完整 URL、Key 与模型 ID。
03
保存后选择该自定义模型，新建短会话；出现 empty content 时核对响应结构和流式事件，而不只看 HTTP 200。
详细修复步骤
Step 01
找到实际生效的配置
确认正在使用的 TRAE 版本、国内或国际版本及自定义模型入口；记录“完整 URL”开关状态。
Step 02
核对协议与凭据
先按模型通道选择 OpenAI Chat Completions 或 Anthropic Messages，再配置对应完整 URL、Key 与模型 ID。
Step 03
回到新会话验证
保存后选择该自定义模型，新建短会话；出现 empty content 时核对响应结构和流式事件，而不只看 HTTP 200。
正确配置
打开“完整 URL”时，Chat Completions 填 https://api.apizt.com/v1/chat/completions；Messages 填 https://api.apizt.com/v1/messages。关闭时由客户端拼接，必须检查最终路径。
模型 ID：从当前平台授权列表复制，不能用显示名称代替。
API Key：在客户端安全输入；本页无需提供。
成功判据：确认最终 URL 与选定 API 格式一致，返回有效文本且平台有对应日志；再验证一个最小工具任务。常见原因
- 完整 URL 开启时填写 /v1 会请求到错误位置；关闭时粘贴完整端点可能造成路径重复。
- 模型校验成功不证明 Builder、工具调用和长上下文都可用；逐项测试需要的功能。
不要这样填
API Key: Bearer sk-xxx怎么确认已经修好
- 确认最终 URL 与选定 API 格式一致，返回有效文本且平台有对应日志；再验证一个最小工具任务。
- 记录客户端版本、请求时间、模型 ID、HTTP 状态和请求 ID。文字成功后再测试所需工具、图片或长上下文功能。
- 页面提供配置核对与复测步骤，没有连接你的客户端；本页未提供该客户端的真实付费调用验证结果。
避免下次再报错
- 团队内统一一份 Base URL 和模型名，不要让每个人从不同教程复制配置。
- 给生产任务和个人调试任务分开 API Key，方便定位是谁触发了限流或余额消耗。
- 工具升级后先保留旧配置备份，再用一个短 prompt 验证连通性。
- 把正确配置写进团队文档，尤其标明 Claude Code 和 OpenAI 兼容工具的 Base URL 差异。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
Trae API key failed 要把 Bearer 一起填进去吗？
普通 Key 字段填写令牌本身，去掉 Bearer、引号和首尾空格；按当前 API 格式由客户端生成鉴权。不要混用其他平台 Key 与 apizt 地址。
Trae Key 正确仍验证失败先看什么？
检查完整 URL 开关、最终路径、API 格式和准确模型 ID，再看状态码与平台记录。错误由路径或协议造成时，重新生成 Key 不能单独修复。
TRAE 应该填写哪个 API 地址？
打开“完整 URL”时，Chat Completions 填 https://api.apizt.com/v1/chat/completions；Messages 填 https://api.apizt.com/v1/messages。关闭时由客户端拼接，必须检查最终路径。
终端请求成功，为什么客户端仍然失败？
完整 URL 开启时填写 /v1 会请求到错误位置；关闭时粘贴完整端点可能造成路径重复。 模型校验成功不证明 Builder、工具调用和长上下文都可用；逐项测试需要的功能。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。