1. 引言
算交所OpenAI
  • 引言
    • 获取令牌
    • 一个完整的请求案例
    • 关于缓存创建与命中
    • 联系客服
    • 定价说明
    • 常见接口错误类型说明
    • 关于 AI 大模型鉴别真伪的系统性方案
    • 在TRAE中使用自定义模型
    • 模型质量监控与保障说明
  • 模型介绍
    • GPT 系列
    • Claude 系列
    • Gemini 系列
    • DeepSeek系列
    • 百度文心一言
    • 阿里通义千问
  • 模型接口
    • 火山豆包模型调用说明
    • 模型查询相关
      • 计费日志开放API
      • 模型列表查询
      • 令牌用量查询
      • 获取账号信息
    • 聊天(Chat)
      • OpenAI
        • 基础聊天(ChatCompletions格式)
          • 基础文本对话
          • 流式响应
          • 内容补全(早期接口)
          • PDF文件分析
          • 代码生成(codex)
          • 结构化输出
          • 联网搜索
          • GPTs对话
        • 会话聊天(Responses格式)
          • 基础文本响应
          • 图像分析响应
          • 网络搜索工具
          • 文件搜索工具
          • 计算机模拟
          • 深度研究
          • 函数调用
          • 推理能力
      • Google Gemini
        • 文本聊天
        • 媒体识别
        • 视频理解
      • Anthropic Claude
        • 文本生成
        • 图片理解
        • 深度思考
        • 函数调用
        • 联网搜索
        • 带缓存创建的文本对话
    • 图像(Images)
      • Midjourney
        • 文生图(Imagine)接口
        • 按钮点击(Action)接口
        • 图片融合(Blend)接口
        • 窗口执行(Modal)接口
        • 图生文(Describe)接口
        • 缩短提示词(Shorten)接口
        • 换脸(FaceSwap)接口
        • 上传(upload)接口
        • 查询接口
        • 批量查询接口
        • 获取种子(Seed)接口
        • 编辑图片(Edit)接口
        • 生成视频(Video)接口
      • OpenAI
        • 图片生成 / gpt-image-1.5
        • 图片生成 / dall-e-3
        • 图片编辑 / edits接口
        • 图片变体生成
        • gpt-4-all(生成图片)
      • Google Gemini
        • OpenAI聊天格式
          • 图片生成(Nano-banana2)
          • 图片生成 / Imagen 4
        • Gemini原生格式
          • 图像生成
      • 豆包(Doubao)
        • 文生图(纯文本输入单图输出)
        • 图文生图(单图输入单图输出)
        • 多图融合(多图输入单图输出)
        • 组图输出(多图输出)
      • 阿里通义千问
        • 文生图-Z-Image
        • 文生图
        • 文生图V2版
        • 文生图V1版
    • 视频(Videos)
      • OpenAI兼容接口
        • Veo 视频生成(OpenAI 兼容格式)
        • 查询视频生成状态 Copy
        • luma
        • runway
      • Veo 3
        • Veo 视频生成
        • 查询视频生成状态
      • Sora-2
        • Sora-2(创建视频)
        • Sora2官方接口(Chat格式)
        • 查询视频(异步任务)
        • 获取视频内容
      • 阿里通义千问
        • 通义万相2.6(创建视频)
        • 查询视频(异步任务)
      • 豆包(Doubao)
        • 豆包-文生视频
        • 查询视频
      • 可灵AI(Kling)
        • 可灵AI-文生视频
        • 可灵AI-文生视频kling-video-o1
        • 可灵AI-图生视频
      • 即梦(Jimeng)
        • 即梦AI-文生视频S2.0Pro
    • 音频(Audio)
      • 原生OpenAI格式
        • 文本转语音 / TTS
        • 语音转文本 / whisper-1
        • 语音转文本 / gpt-4o-transcribe
        • 音频翻译
        • Audio接口 / 输出
        • Audio接口 / 输入
        • MiniMax语音合成TTS
        • 豆包语音2.0
      • 原生Gemini格式
    • 音乐(Music)
      • Suno
        • 生成歌曲
        • 生成歌词
        • 上传音乐
        • 歌曲拼接
        • 单个查询任务
        • 批量查询任务
      • Udio
        • Udio(Chat格式)
    • 嵌入(Embeddings)
      • 创建文本嵌入(OpenAI)
      • 批量创建嵌入(OpenAI)
      • 创建文本嵌入(Gemini)
    • 重排序 (Rerank)
      • Jina AI 重排序格式
      • Cohere 重排序格式
      • Xinference 重排序格式
    • 审查(Moderations)
      • 创建内容审核
  1. 引言

在TRAE中使用自定义模型

最新版TRAE(Cline)自定义服务商配置教程#

一、配置前提说明#

2026年最新版TRAE原生IDE,已彻底移除自定义服务商、自定义Base URL的官方入口,仅支持内置合作模型,无法直接配置私人中转、自建API等第三方服务商。
当前唯一可行方案:通过 VS Code 中的 Cline 插件(原TRAE官方衍生插件)完成自定义服务商配置,该插件支持OpenAI兼容协议的中转/自建接口,可正常使用AI编程能力。

前置准备#

1.
安装 VS Code 编辑器
2.
备好第三方中转/自建服务的 Base URL、API Key、可用模型ID
3.
确保服务商接口遵循OpenAI兼容规范,支持标准对话接口调用

二、Cline插件安装#

1.
打开VS Code,点击左侧扩展图标(快捷键 Ctrl+Shift+X / Cmd+Shift+X)
2.
在搜索框输入 Cline,找到对应插件点击安装
3.
安装完成后,左侧栏会出现Cline专属机器人图标
img.png

三、打开API配置入口#

1.
点击VS Code左侧栏的Cline图标,打开插件主界面
2.
在Cline聊天窗口的右上角,找到齿轮形状的设置图标,点击进入API配置页面
img_1.png

四、核心参数配置(关键步骤)#

进入配置页面后,按以下要求填写各项参数,适配自定义中转服务商:
1.
API Provider(API提供商):务必选择 OpenAI Compatible(OpenAI兼容),切勿选原生OpenAI
2.
Base URL(接口地址):填写中转/自建服务地址,必须以/v1结尾,结尾不加多余斜杠
✅ 正确示例:https://xxx.com/v1
❌ 错误示例:https://xxx.com/、https://xxx.com、https://xxx.com/v1/
3.
OpenAI Compatible API Key:填写第三方服务商提供的密钥
4.
Model ID(模型ID):填写服务商支持的对应模型名称,需严格匹配,大小写敏感

五、保存配置并测试#

1.
核对所有参数无误后,点击页面底部的保存/应用按钮
2.
返回Cline聊天窗口,发送简单指令(如“帮我写一段Hello World代码”),测试接口是否连通
3.
若正常回复,说明配置成功;若报错,参照下方排查方案处理
img_2.png

六、Base URL填写规范(必看)#

1.
必须遵循OpenAI兼容接口规范,末尾固定拼接/v1,这是接口调用的标准路径
2.
结尾禁止加斜杠,避免接口拼接出现双斜杠,导致请求失败
3.
不要省略https协议头,确保地址格式完整
4.
切勿填写纯域名、后台主页地址,必须指向API接口路径

七、常见避坑指南#

1.
TRAE原生IDE无任何自定义服务商入口,不要在原生客户端反复查找,避免浪费时间
2.
API提供商选错会导致配置失效,必须选OpenAI Compatible,不可选原生OpenAI、Anthropic等内置选项
3.
模型ID必须和服务商完全一致,写错名称会触发模型不存在报错
4.
部分中转服务商需额外配置请求头,按服务商要求补充即可

八、常见问题排查#

1. 接口请求失败/超时#

检查Base URL是否正确、网络是否连通、服务商接口是否正常运行

2. 密钥无效#

核对API Key是否复制完整,有无多余空格、字符遗漏

3. 模型不存在#

确认Model ID和服务商支持的模型名称完全一致,区分大小写

4. 路径错误#

检查URL是否以/v1结尾,有无多余斜杠、路径缺失

九、补充说明#

该配置方式为当前最新版TRAE唯一可用的自定义服务商方案,依托Cline插件实现,无法和TRAE原生IDE的右侧主聊天区打通,仅能在VS Code的Cline插件内使用,属于官方商业策略下的兼容方案,适合需要使用私人中转的场景。
修改于 2026-03-26 15:04:05
上一页
关于 AI 大模型鉴别真伪的系统性方案
下一页
模型质量监控与保障说明
Built with