ZH

搜索

配置 OpenCode 使用 Earbowe API

在 OpenCode 的 opencode.json 中把 Earbowe 加为 OpenAI 兼容自定义提供商。

Admin2 分钟阅读
opencodecoding-agentssetup

配置 OpenCode 使用 Earbowe API

OpenCode 支持通过 opencode.json 添加自定义提供商。你可以把它指向任何 OpenAI 兼容网关——包括 Earbowe。

写法参考成熟网关文档的通用模式：自定义 baseURL + @ai-sdk/openai-compatible。

1. 获取密钥

在 Earbowe 控制台 创建 API 密钥。

2. 选择 Base URL

区域 Base URL
全球 https://api.earbowe.com/v1
国内直连 https://api.3861343.xyz/v1

务必包含 /v1。

3. 先验证模型列表

Terminal window
curl -s https://api.earbowe.com/v1/models \
  -H "Authorization: Bearer sk-YOUR-KEY" | head -c 500

从返回里复制精确的模型 id，不要用营销名称瞎填。

4. 在 OpenCode 添加自定义提供商

编辑 opencode.json（项目级或用户级，取决于你的启动方式）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "earbowe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Earbowe",
      "options": {
        "baseURL": "https://api.earbowe.com/v1",
        "apiKey": "{env:EARBOWE_API_KEY}"
      },
      "models": {
        "gpt-4o-mini": {
          "name": "GPT-4o mini"
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        }
      }
    }
  },
  "model": "earbowe/gpt-4o-mini"
}

导出密钥：

Terminal window
export EARBOWE_API_KEY="sk-YOUR-KEY"

说明：

  • OpenAI 兼容网关通常用 @ai-sdk/openai-compatible
  • models 里的 key 应与 /v1/models 的 id 一致
  • 默认模型常见格式：provider/model → earbowe/gpt-4o-mini

5. 国内直连

只改 baseURL：

"options": {
  "baseURL": "https://api.3861343.xyz/v1",
  "apiKey": "{env:EARBOWE_API_KEY}"
}

6. 常见问题

症状 处理
鉴权失败 检查 EARBOWE_API_KEY 是否导出且以 sk- 开头
模型不存在 重新拉 /v1/models 并更新 models 映射
超时 改用国内直连 Base URL
adapter 找不到 确认 OpenCode 能安装 @ai-sdk/openai-compatible

相关

相关文章