文档 · 接入指南

opencode 接 TopxAI：opencode.json 里的自定义供应商

2026-09-19

在 opencode.json 里用 @ai-sdk/openai-compatible 声明 TopxAI，写上基础地址和模型 ID，然后用 /models 选择。

opencode 在 opencode.json（项目内或 ~/.config/opencode/）里接受自定义供应商。一段 @ai-sdk/openai-compatible 的配置覆盖全部 TopxAI 文本模型；再加一段 @ai-sdk/anthropic 让 Claude 走 Messages 接口。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "topxai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TopxAI",
      "options": {
        "baseURL": "https://ai.topxea.com/v1",
        "apiKey": "{env:TOPXAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5",
          "limit": { "context": 1000000, "output": 128000 }
        },
        "gpt-6.1-sol": {
          "name": "GPT-6.1 Sol",
          "limit": { "context": 1000000, "output": 128000 }
        },
        "grok-4.7": {
          "name": "Grok 4.7",
          "limit": { "context": 500000, "output": 128000 }
        },
        "kimi-k3": {
          "name": "Kimi K3",
          "limit": { "context": 1000000, "output": 128000 }
        }
      }
    },
    "topxai-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "TopxAI (Anthropic API)",
      "options": {
        "baseURL": "https://ai.topxea.com/v1",
        "apiKey": "{env:TOPXAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" }
      }
    }
  }
}

然后：

export TOPXAI_API_KEY=sk-...
opencode

用 /models 选模型，供应商名会显示为分组标题。

说明

{env:TOPXAI_API_KEY} 从环境变量读密钥，{file:~/.secrets/topxai} 从文件读。两种都不把密钥写进配置。
@ai-sdk/anthropic 包要求基础地址以 /v1 结尾，自己拼 /messages；@ai-sdk/openai-compatible 包自己拼 /chat/completions。
limit 是 opencode 算上下文余量用的，上面填的是模型自身的窗口，不是 TopxAI 的限制。
模型 ID 要和目录完全一致；带密钥请求 GET https://ai.topxea.com/v1/models 能列出来。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

opencode 接 TopxAI：opencode.json 里的自定义供应商

opencode.json

说明

不通时

相关