Trae 接入
首次会话积分消耗偏高属正常现象
Agent 每次请求都会携带固定的工具定义和系统提示（通常有数万 token）。首次会话这部分内容需要写入缓存，按全量输入计费，所以消耗的积分会比较多；之后的请求命中缓存，这部分按低价缓存计费，消耗会明显下降。这是正常现象，并非多扣费。如有大量使用需求，请联系客服，我们可提供优惠。
Trae（TRAE IDE）的自定义模型走 OpenAI Chat Completions。在 设置 → 模型 → 添加模型 → 自定义配置 里填写 API 格式、请求地址、模型 ID 和 API Key。Agent 模式会在同一次请求里带上 tools。
Trae 不能自动获取模型列表。请从 全部模型 ID 复制模型 ID 手动填写。能自动获取的工具优先用 GET https://modelfold.ai/v1/models。
地址规则以 TRAE 官方文档为准（2026-11-09 核对）：自定义模型（国内）、Built-in models and custom models。国内版更新日志：2026-04-14，v3.3.51 起「支持为自定义模型配置自定义请求地址」。国际版同一天的 v3.5.51 是同一项能力。
v3.3.51 刚上线时，社区教程要求把地址写成完整接口、由客户端原样使用。现行官方文档不是一律原样：请求地址旁边有 完整 URL 开关，两种写法都有效，最终都要打到 https://modelfold.ai/v1/chat/completions。
下面的连通性是用 API Key 直接请求这个地址核对的（普通对话、stream: true、带 tools），没有在 Trae 窗口里点选。
添加模型
- 打开 控制台 → API Keys，创建一个
mf-开头的 Key。下面只填原始 Key，不要自己加Bearer。 - 在 IDE 或 Agent 窗口打开 设置 → 模型，点 添加模型。
- 选 自定义配置（有的版本写「自定义模型」）。不要选预设服务商里的 OpenAI：那个通道走的是 OpenAI 官方地址。
- API 格式 选 OpenAI Chat Completions。Claude、GPT、Gemini 在本页都用这一格式。不要选 Anthropic Messages，那会去请求
/v1/messages。 - 按下一节填请求地址。不要在末尾加斜杠。
- 模型 ID 填目录里的 id，例如
claude-sonnet-4-6。展示名称可以留空，留空时列表里显示模型 ID。 - API 密钥 粘贴
mf-Key。 - 点 添加模型。Trae 会先探测 Key。成功后在对话或 Agent 的模型列表里选这条。
高级配置里的「模型系列」留 默认 即可。本页实测没有改 Temperature，也没有改成 GPT-5 / GPT-6 系列（那些选项会把最大长度字段换成服务商自己的字段名）。
截图占位
设置 → 模型 → 添加模型，底部的「自定义配置」。正式截图待补。
两种请求地址
官方说明（国际版文档里的例子写得最清楚）：
| 完整 URL | 你填的地址 | Trae 怎么用 | ModelFold 填这个 |
|---|---|---|---|
| 关闭（默认） | 基础地址 | 按 API 格式自己拼接路径。OpenAI Chat Completions 只补 /chat/completions，所以基础地址要自己带 /v1 | https://modelfold.ai/v1 |
| 打开 | 完整请求地址 | 原样使用，不再拼接 | https://modelfold.ai/v1/chat/completions |
两种都不要写成官网首页，也不要写成 https://modelfold.ai/v1/（末尾多一个斜杠）。关闭开关时再带上 /chat/completions，会被拼成 /chat/completions/chat/completions。
截图占位
完整 URL 关闭，请求地址为 https://modelfold.ai/v1。正式截图待补。
截图占位
完整 URL 打开，请求地址为 https://modelfold.ai/v1/chat/completions。正式截图待补。
推荐模型
模型 ID 以 GET https://modelfold.ai/v1/models 返回的 id 为准。下表是 2026-11-09 在这个列表里核对过、并且用测试 Key 打过 POST /v1/chat/completions 的型号。
| 模型 ID | 普通对话 | 流式 stream: true | 工具调用 tools | 建议 |
|---|---|---|---|---|
claude-sonnet-4-6 | 通 | 通（SSE，正文逐段返回） | 通（finish_reason 为 tool_calls） | 对话和 Agent 都可以 |
gpt-6-sol | 通 | 通 | 通 | 对话和 Agent 都可以 |
gemini-3-8-flash | 通 | 通 | 通 | 对话和 Agent 都可以。模型页仍标着「仅支持对话调用」，这次 Chat Completions 的工具调用已经返回标准 tool_calls。输出上限设得很小时，思考会占满额度，可见正文可能是空的 |
gemini-3-pro | 不稳定 | 这次通 | 不通 | 不要用于 Agent。见下面的常见问题 |
gemini-3.1-pro 在目录里，同一次工具调用探测返回 502，本页不推荐。
常见问题
| 现象 | 原因和处理 |
|---|---|
| 404，或页面 HTML | 少了 /v1。请求打到 https://modelfold.ai/chat/completions 时，站点返回的是网页 404，不是接口。完整 URL 关闭时填 https://modelfold.ai/v1；打开时填到 /v1/chat/completions。 |
{"ok":false,"error":"not_found"} | 路径多了一层。https://modelfold.ai/v1/v1/chat/completions 就是这种。通常是完整 URL 开着，地址里却又写了会被再拼一次的后缀，或基础地址里多写了 /v1。 |
401，invalid_api_key | Key 不是 mf- 加一段十六进制再加下划线的格式时，返回「缺少或格式不正确的 API Key」。格式对但 Key 不存在或已注销时，返回「API Key 无效或已注销」。不要在密钥框里加 Bearer 。请求头是 Authorization: Bearer，由 Trae 自己加。 |
| 填了 ModelFold，请求却去了别的地址 | 启动 Trae 的环境里如果有 OPENAI_BASE_URL 或 OPENAI_API_BASE，OpenAI 兼容客户端会用环境变量里的地址，设置页填的地址不生效。Key 和地址不是同一家时就是 401，路径被拼到错误域名上时就是 404。从 shell 配置里去掉这两个变量，完全退出 Trae，再从启动台打开，不要从已经 export 过变量的终端启动。 |
| Agent 不执行工具，回复里是一段 JSON | 模型没有返回 tool_calls。gemini-3-pro 目前就是这样：工具定义没有按 OpenAI 工具调用返回，正文里会出现手写的 JSON。换 claude-sonnet-4-6、gpt-6-sol 或 gemini-3-8-flash。 |
| 选了 Gemini 3 Pro，回答却不像这个模型 | gemini-3-pro 固定走原上游，失败后由应答接管。2026-11-09 的一次普通对话，响应里的 model 是 gpt-6-luna，不是 gemini-3-pro。同日的流式请求则由 gemini-3-pro 自己返回。要稳定用 Gemini，选 gemini-3-8-flash。 |