必须满足trae v3.3.51+版本、获取目标模型api key、填写精确到/v1/chat/completions等端点的完整api url三项条件，缺一不可；版本不足则无法启用自定义配置，url不完整将导致404错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Trae中成功接入自定义AI模型，必须提前准备好三项关键要素：对应服务商的API密钥、精确到端点的完整请求地址、以及满足版本要求的Trae客户端，缺一不可。
确认Trae版本是否达标
第一步：打开Trae → 点击右上角头像 → 进入「设置」→ 切换到「关于」页，查看当前版本号。
第二步：若显示版本低于【V3.3.51】，必须前往trae.cn下载最新安装包并覆盖安装。旧版本无法填写完整API URL路径，会卡在“自定义请求地址”字段不可编辑状态。
这一步不能跳过——哪怕只差一个小版本，界面里就根本找不到“添加模型”里的“自定义”选项。
获取目标模型的服务凭证
方法一：阿里云百炼
登录百炼控制台 → 进入「API密钥管理」→ 创建新密钥 → 复制sk-开头的密钥字符串 → 立即保存到本地文本文件（页面关闭后密钥将永久不可见）。
方法二：DeepSeek开放平台
访问 platform.deepseek.com → 登录后进入「API Keys」→ 点击「Create new key」→ 命名用途（如“trae-dev”）→ 生成 → 同样必须立刻复制并存档，后台不保留明文密钥。
方法三：本地Ollama或FastAPI服务
确保服务已启动且可访问（如 http://localhost:11434/v1/chat/completions），无需API Key，但需确认该端点返回符合OpenAI格式的JSON响应。
准备正确的API请求地址
第一步：明确服务商协议类型。Trae仅支持OpenAI Chat Completions格式，不兼容Anthropic或Google Gemini原生接口。
第二步：地址必须包含完整路径，不能只填域名。例如：
✅ 正确写法：https://api.deepseek.com/v1/chat/completions
❌ 错误写法：https://api.deepseek.com 或 https://api.deepseek.com/v1 —— 这会导致测试失败并返回404。
第三步：验证地址可用性。可直接用curl或Postman发送一个空body的POST请求，检查是否返回{"error": "invalid_api_key"}类提示（说明地址通，只是密钥未传）；若返回404或连接超时，则地址有误。
注意：腾讯云LKEAP的地址为 https://api.lkeap.cloud.tencent.com/plan/v3，末尾无/v1/chat/completions，这是特例，必须严格按其文档填写。
