SilkAPI 使用文档

Appearance

OpenCode 使用教程 ​

OpenCode 是终端里的 AI coding agent，支持自定义 provider。对于 SilkAPI，可以使用 OpenAI-compatible provider 配置。

准备工作 ​

请先准备：

  • SilkAPI API Key
  • SilkAPI Base URL
  • 模型名称

示例 Base URL：

text
https://api.silkapi.com/v1

添加凭据 ​

在 OpenCode 中运行：

text
/connect

选择 Other，输入 provider id：

text
silkapi

然后输入 SilkAPI API Key。这个步骤只保存凭据，仍需要在 opencode.json 中声明 provider。

配置 opencode.json ​

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

text
opencode.json

写入：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "silkapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SilkAPI",
      "options": {
        "baseURL": "https://api.silkapi.com/v1"
      },
      "models": {
        "your-model-name": {
          "name": "SilkAPI Model"
        }
      }
    }
  }
}

把 your-model-name 替换为 SilkAPI 支持的模型名称。

如果你不想使用 /connect 保存凭据，也可以通过环境变量传入 API Key：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "silkapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SilkAPI",
      "options": {
        "baseURL": "https://api.silkapi.com/v1",
        "apiKey": "{env:SILKAPI_API_KEY}"
      },
      "models": {
        "your-model-name": {
          "name": "SilkAPI Model"
        }
      }
    }
  }
}

然后设置：

bash
export SILKAPI_API_KEY="你的 SilkAPI API Key"

选择模型 ​

启动 OpenCode 后运行：

text
/models

选择 SilkAPI 下的模型。

常见问题 ​

找不到 SilkAPI provider ​

确认 opencode.json 位于当前项目目录，且 provider id 与 /connect 中填写的 id 一致。

请求报错 ​

确认 npm 使用 @ai-sdk/openai-compatible，并检查 options.baseURL 是否为 SilkAPI 的 OpenAI 兼容地址。

参考：OpenCode Providers