OpenCode AI网关：通过一个API连接多个LLM

一个 OpenCode AI 网关为您的终端工作流程和您实际想使用的模型之间提供了一个稳定的 API 层。如果您正在处理不同的供应商密钥、不同的计费页面以及不同的可用性风险，那么这个额外的层可以让 OpenCode 的日常运行变得更加轻松。.

ShareAI 很适合这个角色，因为它为 150+ 模型提供了一个 API，并且具有智能路由、故障转移和市场可见性功能。OpenCode 已经支持自定义 OpenAI 兼容的供应商，因此设置主要是将 OpenCode 指向正确的基础 URL 并添加您想使用的模型。.

本指南是我们 开发者 关于 AI 路由、模型访问和生产就绪集成的文章。.

为什么首先要使用 OpenCode AI 网关？

OpenCode 设计为支持多个供应商，其公共文档显示支持自定义供应商配置、自定义 baseURL 值和 OpenAI 兼容的端点。这种灵活性非常强大，但它也意味着当您真正想要的是一个简洁的编码工作流程时，您可能最终需要分别管理每个供应商。.

• 一个 API 密钥，而不是每个模型供应商一个密钥。.
• 一个计费界面，而不是多个仪表板。.
• 在模型之间更清晰地切换，以便快速编辑、长上下文任务或更复杂的重构。.
• 一个路由层，当供应商速度慢、不可用或不再适合工作时可以提供帮助。.

对于希望灵活性但不想维护单独供应商连接的开发者来说，这通常是 AI 网关开始物有所值的地方。.

OpenCode 如何支持此设置

根据官方 OpenCode 供应商文档, ，您可以通过 opencode.json, 自定义提供者设置， baseURL, 设置一个自定义 ，并使用 @ai-sdk/openai-compatible 适用于OpenAI兼容的提供者。公共 OpenCode GitHub存储库.

还记录了其配置路径，并确认该工具是为提供者级别的灵活性而构建的。.

这意味着您不需要特殊的ShareAI集成包即可开始使用。您可以将ShareAI添加为自定义提供者，将您的API密钥保存在环境变量中，然后选择您希望OpenCode调用的确切模型。

第一步：创建您的ShareAI API密钥并选择一个模型 创建一个 API 密钥. 首先在 ShareAI 模型市场的模型 ID 中生成凭据。然后浏览.

以决定哪个模型应该支持您的OpenCode工作流程。.

一个实用的模式是选择一个默认模型用于日常编码任务，并记住一到两个备选方案，以便在您需要更低延迟、更低成本或更强推理模型的情况下使用。

OpenCode允许您定义一个具有OpenAI兼容端点的自定义提供商。一个简单的起始模板如下所示：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

替换 你的-shareai-模型 使用您希望从ShareAI模型目录中使用的确切模型标识符。将API密钥从文件中移除，并通过环境变量加载它。.

export SHAREAI_API_KEY="your_api_key_here"

如果您需要更广泛的请求格式和认证详情， API参考 涵盖了核心ShareAI API流程。.

第三步：无需重建设置即可切换模型

一旦ShareAI成为提供层，模型更改就变得更加轻松。您不再需要每次测试不同模型时重新处理供应商认证。相反，您保持相同的API界面并更改OpenCode指向的模型。.

当您的编码工作流程因任务而变化时，这尤其有用。您可能需要一个模型用于快速编辑，另一个用于更大的代码库推理，还有一个作为备用，当成本或延迟比峰值能力更重要时。您可以在以下内容中比较选项： 模型市场 并在以下内容中进行行为检查： 操场 在您锁定默认设置之前。.

当直接使用提供商密钥仍然有意义时

在某些情况下，直接使用是合理的。如果您依赖于提供商特定的测试版功能、私人企业协议或严格的提供商内部治理设置，您可能希望保持该路径独立。.

但对于主要希望OpenCode保持灵活、可移植且易于操作的团队来说，使用OpenCode AI网关通常是更清晰的默认选择。它减少了账户扩散，并让您根据性能和适配性评估模型，而不是根据您最近配置的供应商登录。.

最终要点

OpenCode AI 网关并不是为了增加更多工具而存在，而是为了保持一个编码工作流程，同时为自己留出更换模型、比较提供商以及在底层模型格局变化时继续前进的空间。如果这正是您对 OpenCode 的期望，ShareAI 通过一个 API 为您提供了一种实用的实现方式。.