Skip to main content

在itBuilder中使用OpenAI兼容的提供商

itBuilder支持多种提供OpenAI API标准兼容API的AI模型提供商。这意味着您可以使用非OpenAI的提供商模型，同时仍然使用熟悉的API接口。这包括以下提供商：

  • 本地模型 通过Ollama和LM Studio等工具运行(在单独章节中介绍)。
  • 云提供商 如Perplexity、Together AI、Anyscale等。
  • 任何其他 提供OpenAI兼容API端点的提供商。

本文档重点介绍非官方OpenAI API(有专门的配置页面)的设置。

通用配置​

使用OpenAI兼容提供商的关键是配置两个主要设置：

  1. 基础URL: 这是提供商的API端点。它不会是https://api.openai.com/v1(这是官方OpenAI API的)。
  2. API密钥: 这是您从提供商处获取的密钥。
  3. 模型ID: 这是特定模型的名称。

您可以在itBuilder设置面板(点击图标)中找到这些设置：

  • API提供商: 选择"OpenAI兼容"。
  • 基础URL: 输入您选择的提供商提供的基础URL。这很关键。
  • API密钥: 输入您的API密钥。
  • 模型: 选择一个模型。
  • 模型配置: 这允许您自定义模型的高级配置
    • 最大输出令牌(Max Output Tokens)
    • 上下文窗口(Context Window)
    • 图像支持(Image Support)
    • 计算机使用(Computer Use)
    • 输入价格(Input Price)
    • 输出价格(Output Price)

支持的模型(针对OpenAI原生端点)​

虽然此提供商类型允许连接到各种端点，但如果您直接连接到官方OpenAI API(或完全镜像它的端点)，itBuilder会根据其源代码中的openAiNativeModels定义识别以下模型ID：

  • o3-mini
  • o3-mini-high
  • o3-mini-low
  • o1
  • o1-preview
  • o1-mini
  • gpt-4.5-preview
  • gpt-4o
  • gpt-4o-mini

注意: 如果您使用不同的OpenAI兼容提供商(如Together AI、Anyscale等)，可用的模型ID会有所不同。始终参考您特定提供商的文档以获取其支持的模型名称。

故障排除​

  • "无效的API密钥": 仔细检查您输入的API密钥是否正确。
  • "找不到模型": 确保您为所选提供商使用有效的模型ID。
  • 连接错误: 验证基础URL是否正确以及您的提供商API是否可访问。
  • 意外结果: 如果得到意外结果，请尝试不同的模型。

通过使用OpenAI兼容的提供商，您可以利用itBuilder的灵活性与更广泛的AI模型。请始终查阅您提供商的文档以获取最准确和最新的信息。