使用 TRAE 集成 GenStudio API

AI 助手

TRAE 是一款 AI 原生 IDE，集成了对话式编程、代码补全与 Agent 能力。TRAE 支持添加自定义模型，可以通过 GenStudio 的 OpenAI 兼容 API 使用 GenStudio 模型。

TRAE 的模型服务商列表中没有 GenStudio，需要通过 自定义模型 添加。本文中的界面和配置项以 TRAE 国内版 3.3.104 为准。

获取 API 接入信息

TRAE 通过 GenStudio 通用 LLM API 调用模型，配置前需要准备 API Key 和 Base URL。LLM API 按 Token 计费，请关注账户余额。

• API Key：创建以 sk- 为前缀的 API 密钥。详见 GenStudio API 快速集成。

  获取通用 API Key

  注意

  GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费，以及享受的 API 频率上限。详见 LLM API 计费规则。

• OpenAI (OpenAI Compatible)

  • Base URL: https://cloud.infini-ai.com/maas/v1

  • Endpoints

    • Create Chat Completion: /chat/completions
    • List Models: /models

查询模型信息

添加模型时需要填写模型 ID，也可以按模型能力设置上下文窗口和图片输入。调用模型列表接口，从对应模型条目中读取以下字段：

curl --request GET \
  --url 'https://cloud.infini-ai.com/maas/v1/models' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

• id：模型 ID。
• context_length：上下文窗口的 Token 数。
• max_output_length：单次输出的最大 Token 数。
• model_type：模型类型，例如 大语言模型、多模态模型。模型是否支持图片输入，以模型广场中模型卡片的说明为准。

例如，deepseek-v4.1-flash-1017 返回的 context_length 为 1048576，max_output_length 为 393216。配置时请以当前账号实际返回的模型条目为准。

添加 GenStudio 模型

1. 打开 TRAE，点击窗口顶部的设置图标（齿轮形状），在设置页左侧选择 模型。

2. 点击 添加模型，在服务商列表中选择 自定义模型。

3. 填写以下必填项：

   • API 格式：选择 OpenAI Chat Completions 格式。
   • 自定义请求地址：填写 https://cloud.infini-ai.com/maas/v1。保持 完整 URL 开关关闭，TRAE 会在地址末尾自动补充 /chat/completions。地址末尾不要加斜杠。
   • 模型 ID：填写 GenStudio 的模型 ID，例如 deepseek-v4.1-flash-1017。模型 ID 仅为示例，可用的模型及其 ID 以 GenStudio 模型广场或 /models 接口的返回结果为准。
   • API 密钥：填写以 sk- 开头的 GenStudio API Key。

4. （可选）填写 模型展示名称。未填写时，模型列表中显示模型 ID。

5. （可选）展开 高级配置，按模型能力调整配置项。各配置项都有默认值，不调整也可以使用。

   配置项	默认值	说明
   模型系列	默认	TRAE 针对部分模型系列优化了 Prompt 和超参数。列表中有对应的系列时可以选择，例如 DeepSeek V4 系列模型选择 Deepseek-4系列。
   上下文窗口（Token）	留空	分别设置输入和输出的 Token 上限。留空时使用 TRAE 的默认值。需要设置时，输入不超过 context_length，输出不超过 max_output_length。
   工具调用轮数	500	模型调用工具的轮数上限。
   支持图片输入	支持	模型不支持图片输入时，选择 不支持。
   思考模式	跟随模型默认配置	也可以选择 开启 或 关闭。
   采样参数	留空	包括 Temperature（0～2）、Top P（0～1）和 Top K（1～100）。留空时使用 TRAE 的默认配置。

6. 点击 添加模型。TRAE 会进行连通性测试，这次测试会发起一次真实请求，消耗少量 Token。

添加后，模型显示在 模型 页的 自定义 分组中，服务商为 自定义(OpenAI Compatible)。在该分组中可以编辑或删除模型，也可以用开关启用或停用模型。

注意

添加后不能修改 自定义请求地址 和 模型 ID，需要修改时，请删除该模型后重新添加。编辑模型时，API 密钥 留空表示保留原来的值。

使用 GenStudio 模型

在对话输入框右下角点击当前模型名称，在 自定义模型 分组中选择添加的模型。然后发送一条简单请求，确认模型可以正常回复：

用一句话介绍当前项目的目录结构。

常见问题

添加模型时连通性测试失败怎么办？

按以下顺序检查配置：

• 自定义请求地址 为 https://cloud.infini-ai.com/maas/v1，末尾没有斜杠，也没有包含 /chat/completions。
• API 格式 为 OpenAI Chat Completions 格式。
• API Key 以 sk- 开头、未被禁用，且账户余额充足。
• 模型 ID 与 /models 返回的 id 完全一致。

也可以用 curl 直接调用接口，确认问题是否来自 TRAE 的配置：

curl --request POST \
  --url 'https://cloud.infini-ai.com/maas/v1/chat/completions' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{"model": "deepseek-v4.1-flash-1017", "messages": [{"role": "user", "content": "你好"}]}'

是否支持图片理解？

是否支持图片理解，取决于当前使用的模型是否具备视觉理解能力。这是模型能力，不是 TRAE 客户端自动为所有模型补充的通用能力。

只有当上游模型本身明确支持图片理解或多模态输入时，您才可以在 TRAE 会话中发送图片。不同模型的能力可能不同，请以 GenStudio 模型广场的说明为准。添加自定义模型时，请按模型能力设置 高级配置 中的 支持图片输入。

发送图片后出现 3003 错误怎么办？

如果您在一个会话中向不支持视觉理解的模型发送了图片，TRAE 可能会返回 3003 错误码。

出现这种情况后，继续在当前会话中重试，或者在当前会话里切换模型，通常都无法恢复。唯一可靠的处理方式是新建一个会话，然后在新会话中选择支持视觉理解的模型，再重新发送图片。

为什么 TRAE 会报 3003 错误？

TRAE 的 3003 是一个覆盖范围较广的错误，并不只表示"模型不支持图片理解"。尤其是在使用自定义模型时，3003 可能由多种原因触发。

常见情况包括：

• 上游 API 提供商返回 429：这通常表示触发了频率、并发或配额限制。此时一般需要等待一段时间后再重试。
• 上游 API 提供商返回 500：这通常表示上游模型服务暂时异常。建议先使用本地 curl 直接测试 API 请求，确认问题是否来自上游服务本身。
• 在当前会话中向不接受图片输入类型的模型发送图片：如前文所述，这也可能触发 TRAE 的 3003 错误。

相关文档

• TRAE 官方文档
• GenStudio API 快速集成
• GenStudio LLM API 错误码