Xikapi 接入文档

配置 Xikapi 模型 ​

OpenCode 的自定义 OpenAI 兼容 provider 需要两步：

  1. 用 /connect 保存凭据。
  2. 在 opencode.json 里配置 provider 和模型。

1. 保存 Xikapi API Key ​

启动 OpenCode：

bash
opencode

在 TUI 里输入：

text
/connect

选择 Other，输入 provider id：

text
xikapi

然后粘贴 Xikapi API Key。

OpenCode 会把凭据保存到本机认证文件中。后续可用：

bash
opencode auth list

检查凭据是否存在。

2. 创建 opencode.json ​

在项目根目录创建或编辑：

text
opencode.json

示例配置：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xikapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Xikapi",
      "options": {
        "baseURL": "https://xikapi.com/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "My Xikapi model"
        }
      }
    }
  }
}

然后在 OpenCode 里运行：

text
/models

选择 Xikapi 下的模型。

使用环境变量保存 Key ​

如果不想通过 /connect 保存凭据，也可以在配置中引用环境变量：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xikapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Xikapi",
      "options": {
        "baseURL": "https://xikapi.com/v1",
        "apiKey": "{env:XIKAPI_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "My Xikapi model"
        }
      }
    }
  }
}

macOS / Linux：

bash
export XIKAPI_API_KEY="YOUR_XIKAPI_API_KEY"

Windows PowerShell：

powershell
$env:XIKAPI_API_KEY="YOUR_XIKAPI_API_KEY"

参考链接 ​