接入 Trae

将 Trae AI IDE 接入 PilotAIHub，统一调用模型并治理 Key。

简介

Trae 是一款 AI 优先的代码编辑器，支持自定义 OpenAI 兼容端点。将其指向 PilotAIHub 网关后，可在 Trae 中调用 PilotAIHub 托管的多模型，并通过虚拟 Key 进行治理与成本归因。

前置条件

已注册 PilotAIHub 账号并创建虚拟 Key。

安装 Trae

访问 trae.cn 下载并安装。支持 macOS / Windows。

配置 base_url

将 Trae 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

打开 Trae → Settings → Models / AI Provider → 选择「自定义 / OpenAI 兼容」→ Override Base URL 填入下方地址、API Key 填入 PilotAIHub Key、模型填入 model_code。

base_url

https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 Trae 的 API Key / Secret 字段：

api_key

sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。Trae 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 Trae 的模型选择处填写 PilotAIHub 支持的 model_code，例如 gpt-4o。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证

curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

进阶用法

在 Trae 的 Chat / Composer 中按需切换模型，平衡速度与能力。
为 Trae 单独建一个低并发 Key，避免占用其他业务额度。
Tab 补全建议使用低延迟模型以保持流畅。

常见问题

自定义模型

Trae 的模型下拉可能预置固定列表，需勾选自定义模型并手动输入 model_code。

401/429 排查见 Cursor 接入。