Lzh on GitHub

OpenAI

将 Roo Code 连接到 OpenAI 官方 API，以访问具有高级推理能力和冗长度控制的 GPT-5、GPT-4o、o1 和 o3 模型。

Roo Code 支持直接通过官方 OpenAI API 访问模型，包括最新的 GPT-5 系列，该系列具有高级功能，如推理努力控制和详细程度设置。

网站: https://openai.com/

获取 API 密钥

  1. 注册/登录: 前往 OpenAI 平台。创建一个账户或登录。
  2. 导航到 API 密钥: 前往 API 密钥页面。
  3. 创建密钥: 点击“创建新密钥”。给您的密钥起一个描述性名称（例如，“Roo Code”）。
  4. 复制密钥: 重要提示: 立即复制 API 密钥。您将无法再次看到它。请妥善保管。

支持的模型

Roo Code 支持以下 OpenAI 模型：

GPT-5 系列（最新）

GPT-5 模型是 OpenAI 最先进的模型，提供卓越的编码能力和代理任务性能：

  • gpt-5-2025-08-07（默认）- 最适合编码和代理任务的模型
  • gpt-5-mini-2025-08-07 - 更快、更经济，适用于明确定义的任务
  • gpt-5-nano-2025-08-07 - 最快、最经济的选择

GPT-4.1 系列

具有平衡能力的高级多模态模型：

  • gpt-4.1 - 高级多模态模型
  • gpt-4.1-mini - 性能均衡
  • gpt-4.1-nano - 轻量级选项

o3 推理模型

具有可配置推理努力的模型，用于解决复杂问题：

  • o3、o3-high、o3-low - 不同的推理努力预设
  • o3-mini（中等推理努力）
  • o3-mini-high（高推理努力）
  • o3-mini-low（低推理努力）

o4 模型

最新的迷你推理模型：

  • o4-mini、o4-mini-high、o4-mini-low

o1 系列

原始推理模型：

  • o1 - 原始推理模型
  • o1-preview - 预览版本
  • o1-mini - 较小的变体

GPT-4o 系列

优化的 GPT-4 模型：

  • gpt-4.5-preview
  • gpt-4o - 优化的 GPT-4
  • gpt-4o-mini - 较小的优化变体

有关最新模型和功能的列表，请参阅 OpenAI 模型文档。

在 Roo Code 中配置

设置

  1. 打开 Roo Code 设置: 点击 Roo Code 面板中的齿轮图标。
  2. 选择提供商: 从“API 提供商”下拉菜单中选择“OpenAI”。
  3. 输入 API 密钥: 将您的 OpenAI API 密钥粘贴到“OpenAI API Key”字段中。
  4. 选择模型: 从“模型”下拉菜单中选择您想要的模型（默认为 gpt-5-2025-08-07）。
  5. （可选）基础 URL: 如果您需要使用自定义基础 URL，请输入该 URL。大多数人不需要调整此项。

高级功能

推理努力控制

对于支持推理的模型（GPT-5、o1、o3、o4 系列），您可以控制模型思考的深度：

GPT-5 模型:

  • minimal - 最快的响应，具有基本推理
  • low - 快速响应，具有轻微推理
  • medium（默认）- 平衡的推理和响应时间
  • high - 深度推理，适用于复杂问题

o1/o3/o4 模型:

  • low - 最短的思考时间
  • medium - 平衡的方法
  • high - 最大的思考，适用于复杂问题

某些模型具有预设的推理级别（例如，o3-high 始终使用高推理）。

详细程度控制

适用于 GPT-5 模型和选定的其他模型，详细程度控制响应的详细级别：

  • low - 简洁、直接的响应
  • medium（默认）- 详细信息均衡
  • high - 全面、详细的响应

温度设置

温度控制输出的随机性（0.0 到 2.0）：

  • GPT-5 模型: 默认值为 1.0，用于平衡创造力
  • 其他模型: 默认值为 0.0，用于确定性输出
  • 注意: 不适用于 o1/o3 推理模型

对话连续性 (GPT-5)

GPT-5 模型通过响应 ID 有效地维护对话上下文，从而在保留上下文的同时减少令牌使用。这会自动发生，无需配置。

提示和注意事项