APIMaster.ai
APIMaster.ai 使用文档
快速开始APIMaster 官网模型广场

TRAE API 密钥设置 — Agent 三方 Key 配置指南

在 TRAE IDE 的 Agent 中配置 APIMaster.ai 三方 API Key。自定义配置 OpenAI Chat Completions 格式，填写 Base URL 与模型 ID，接入 GPT、Claude、DeepSeek 等。

TRAE IDE（字节跳动 AI 原生编程 IDE）内置 Agent 模式，可理解需求、规划任务并自主改代码。TRAE 支持通过 自定义模型 接入第三方 API；APIMaster.ai 提供 OpenAI Chat Completions 兼容 接口，在 TRAE 里添加自定义模型即可使用。

开始前请 获取 API Key。Key 仅保存在本机 TRAE 设置中，勿发到群聊或截图。发消息失败时可使用 API 连通性测试 辅助排查。

前置条件

  1. 已安装 TRAE IDE（官网下载 或 trae.cn）。
  2. 已从 APIMaster 控制台 复制 API Key。
  3. 已在 模型广场 确认目标 model id（如 gpt-5.5、claude-sonnet-4-6、deepseek-v4-pro）。

第 1 步：打开 Agent 并进入模型选择

  1. 打开 TRAE IDE，进入 Agent 对话界面（底部输入框旁显示 @Agent）。
  2. 点击右下角 模型选择器（当前模型名旁的下拉箭头）。
  3. 在弹出菜单底部点击 「添加模型」。

TRAE Agent 界面 — 点击添加模型

第 2 步：填写自定义配置

在 「编辑模型」 对话框中，切换到 「自定义配置」 标签页，按下列字段填写：

字段 填写内容
API 格式 OpenAI Chat Completions 格式
自定义请求地址 https://apimaster.ai/v1（不要以斜杠结尾）
完整 URL 保持 关闭（TRAE 会自动在地址末尾追加 /chat/completions）
模型 ID 从 模型广场 复制的 model id，如 gpt-5.5、claude-sonnet-4-6
多模态 若模型支持图片输入可开启；纯文本模型可关闭
API 密钥 粘贴你的 APIMaster Key

TRAE 编辑模型 — 自定义配置 APIMaster

说明：

  • 自定义请求地址 须为兼容 OpenAI API 的端点，填写 https://apimaster.ai/v1 即可；TRAE 会提示 /chat/completions 将自动追加到末尾。
  • 模型 ID 须与 APIMaster 上架 id 完全一致（大小写、连字符不能错）。
  • 填写完成后点击 「确认」 保存。

第 3 步：选择自定义模型

  1. 再次打开右下角 模型选择器。
  2. 在 「自定义模型」 区域找到刚添加的模型（如 gpt-5.5），点击选中。
  3. 底部模型名应切换为你配置的 id。

TRAE 模型选择器 — 自定义模型已启用

第 4 步：验证 Agent 对话

  1. 在 Agent 输入框发送测试消息（如 hi 或简单编程任务）。
  2. 收到正常回复即表示配置成功。
  3. 若 TRAE 显示 服务商 为 custom_openai_compatible，说明请求正通过 OpenAI 兼容协议经 APIMaster 发出。

TRAE Agent 对话 — custom_openai_compatible 服务商

常用 Model ID 参考

以下 id 与 APIMaster GET /v1/models 一致（以账户实际开通为准）：

model id 说明
gpt-5.4 / gpt-5.5 GPT 系列
claude-haiku-4-5 Claude Haiku，轻量快速
claude-sonnet-4-6 Claude Sonnet，均衡
claude-opus-4-7 / claude-opus-4-8 Claude Opus，更强推理
deepseek-v4-pro / deepseek-v4-flash DeepSeek 系列
gemini-2.5-pro / gemini-2.5-flash Gemini 系列

请从 模型广场 复制最新 id，不要手打或猜别名。

常见问题

现象 处理
401 / Invalid API Key 检查 Key 是否完整；在 TRAE 重新粘贴；在控制台确认未禁用
404 / model not found 模型 ID 与 模型广场 id 不一致；重新复制粘贴
连接超时 确认地址为 https://apimaster.ai/v1（无末尾斜杠）；检查网络与代理
找不到「添加模型」 在 Agent 对话界面右下角模型选择器里；非 Builder 模式的侧边栏 Chat
仍走 TRAE 内置模型 确认已在 自定义模型 区域选中你添加的模型
多模态报错 若模型不支持图片，关闭 多模态 开关后重试

核对清单

  • 已在 TRAE Agent 界面打开模型选择器并点击 添加模型
  • API 格式 = OpenAI Chat Completions 格式
  • 自定义请求地址 = https://apimaster.ai/v1（完整 URL 关闭）
  • 模型 ID 来自 模型广场
  • API 密钥 已填 APIMaster Key
  • 已在模型选择器中选中自定义模型，Agent 能正常回复

相关链接