Trae 等 IDE 客户端配置
https://superapi.buzz适用范围
本页适用于需要填写 OpenAI 兼容接口的 IDE 客户端，例如：
- Trae
- Cursor / Windsurf 这类支持自定义 OpenAI Base URL 的 IDE
- Cline / RooCode / Kilo Code 等 VS Code 插件
- Continue、Aider、Open WebUI 等 OpenAI 兼容客户端
如果客户端明确写的是 Anthropic / Claude Code 配置，请看 Claude Code 配置。如果客户端写的是 OpenAI Compatible、Custom OpenAI、OpenAI API Base URL，一般按本页填写。
网络与并发
Trae 等客户端直接请求 API。如果当前 IP 风险较高，可能被 Cloudflare 拦成 403——换更干净的网络或梯子节点即可，与加白无关。
如需更高并发（默认有并发限制），可到 https://whitelist.superapi.buzz/ 登录并提交公网 IP 加白；不加白也能用，只是受并发限制。
主入口：
https://superapi.buzz遇到 403 Forbidden：换更干净的网络或梯子节点、更换出口 IP；手动查 IP 时可对照 ip138.com 和 hiofd IP 查询 确认实际出口。
Trae 配置
在 Trae 里添加自定义模型服务或 OpenAI 兼容服务，核心只填三项：
Provider / 类型：OpenAI Compatible / 自定义 OpenAI
API Key：sk-你的令牌
Base URL：https://superapi.buzz/v1模型名填写控制台支持的模型，例如：
gpt-5.5
gpt-5.4
gpt-5.3-codex
gpt-5.2如果 Trae 的配置项叫法不同，按这个对应关系理解：
| Trae 配置项 | 填写内容 |
|---|---|
| API Key / Token | sk-你的令牌 |
| Base URL / API Base | https://superapi.buzz/v1 |
| Model / Model ID | 控制台支持的模型名 |
| Provider | OpenAI Compatible / Custom OpenAI |
Base URL 不要填错
OpenAI 兼容客户端一般填 https://superapi.buzz/v1。不要填成 https://superapi.buzz，也不要填成 https://superapi.buzz/v1/responses。
Cursor / Windsurf
在自定义 OpenAI 地址里填写：
API Key: sk-你的令牌
OpenAI Base URL: https://superapi.buzz/v1
Model: gpt-5.5如果客户端支持多个模型，建议先添加一个稳定模型测试，再逐步添加其他模型。不要一次性填大量不存在或未配置价格的模型。
Cline / RooCode / Kilo Code
这些 VS Code 插件一般在 Provider 里选择 OpenAI Compatible：
Provider: OpenAI Compatible
Base URL: https://superapi.buzz/v1
API Key: sk-你的令牌
Model: gpt-5.5注意事项：
- 插件会自动读取项目上下文，Token 消耗通常比 CLI 更高。
- 大项目建议只打开当前任务目录。
- 不要让插件自动索引无关大目录、日志目录、构建产物和依赖目录。
- 出现上下文过大时，先新开任务或减少引用文件。
Continue
Continue 的 OpenAI 兼容配置可按这个思路填写：
{
"models": [
{
"title": "SuperAPI gpt-5.5",
"provider": "openai",
"model": "gpt-5.5",
"apiBase": "https://superapi.buzz/v1",
"apiKey": "sk-你的令牌"
}
]
}不同 Continue 版本字段可能略有差异。上面的 config.json 是本地用户文件（~/.continue/），正常不会进 Git；但不要把这份带明文 token 的配置提交到仓库或分享出去。如果界面里有 OpenAI Compatible 选项，优先用界面填写。
Aider
Aider 可以通过环境变量指定 OpenAI 兼容接口：
macOS / Linux：
export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_API_BASE="https://superapi.buzz/v1"
aider --model openai/gpt-5.5Windows PowerShell：
$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_API_BASE="https://superapi.buzz/v1"
aider --model openai/gpt-5.5如果你的 Aider 版本使用 OPENAI_BASE_URL，则改为：
export OPENAI_BASE_URL="https://superapi.buzz/v1"Open WebUI / LibreChat / 其他面板
这类面板通常添加 OpenAI 连接：
API Base URL: https://superapi.buzz/v1
API Key: sk-你的令牌
Models: gpt-5.5,gpt-5.4,gpt-5.3-codex如果面板会定时拉取模型列表，先用一个令牌小流量测试。多人共用面板时，建议给面板单独创建令牌，方便统计和停用。
fast 与百万上下文
GPT / Codex fast 对应请求参数：
{
"service_tier": "fast"
}在 Codex CLI 中也可以用：
/fast当前 SuperAPI 不再使用单独 fast 分组，而是按请求是否启用 fast 动态计费。客户端里不要再手动选择旧的 *-fast 分组。
GPT 百万上下文超过 272k 的部分会额外计费。IDE 客户端很容易自动塞入大量文件，上下文越大费用越高，建议：
- 只打开当前任务相关目录。
- 明确指定要读取的文件。
- 大日志先裁剪后再发。
- 长会话及时新开或压缩。
更多说明见 fast 与百万上下文。
生图支持
如果客户端支持 OpenAI Responses 的 image_generation 工具或 OpenAI 图片接口，可使用控制台支持的生图模型。常见注意点：
gpt-image-2API 可用。- Codex 内部 skill 生图可用。
- 慢图、大图、多图建议使用流式和 partial images。
- 非流式长时间生图可能被客户端或 CDN 超时中断。
最小测试
配置后先发一个小请求：
你好，请只回复 OK如果客户端支持模型列表，也可以先测试：
curl https://superapi.buzz/v1/models \
-H "Authorization: Bearer sk-你的令牌"常见错误
| 错误 | 常见原因 | 处理 |
|---|---|---|
| 401 Unauthorized | Token 错误、复制多空格、令牌被删 | 重新创建令牌并完整复制 |
| 403 Forbidden | IP 风险高被 Cloudflare 拦截（与加白无关） | 换更干净的网络或梯子节点、更换出口 IP；可对照 ip138.com 和 hiofd 确认实际出口 |
| 404 Not Found | Base URL 填错 | OpenAI 兼容客户端填 https://superapi.buzz/v1 |
| 429 Too Many Requests | 上游限流或并发过高 | 降低并发，等待恢复，换模型或分组 |
| 503 Service temporarily unavailable | 当前模型/分组/账号池暂不可用 | 换同系列模型或稍后重试 |
| context too large | IDE 自动塞入过多文件 | 减少上下文、新开任务、只引用关键文件 |
配置检查清单
上线正式使用前确认：
- 已在
https://superapi.buzz注册并登录（如需更高并发，可在 whitelist 入口加白）。 - Base URL 是
https://superapi.buzz/v1。 - Token 是
sk-开头的 SuperAPI 令牌。 - 模型名在控制台可用。
- 没有把 token 写入会提交到 Git 的文件。
- 已用小请求验证成功。