OpenCode

接入准备

准备网关根地址、允许模型的虚拟密钥和公开模型名，先测试 GET /v1/models。

配置步骤

将此自定义供应商添加到 opencode.json，设置 XHUB_API_KEY 后重启，选择 xhub/YOUR_MODEL_NAME。OpenAI compatible 适配器使用 Chat completions。

验证与故障排查

发送英文提示 “Hello, introduce yourself.”，在 XHub 请求日志核对调用 ID。流式、工具调用与图片能力需按部署分别验证。401 检查虚拟密钥，403 检查模型范围，404 检查地址与重复 /v1。客户端设置随版本变化。

请求示例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xhub": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "XHub",
      "options": {
        "baseURL": "http://localhost:4000",
        "apiKey": "{env:XHUB_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_NAME": {
          "name": "YOUR_MODEL_NAME"
        }
      }
    }
  }
}