接入文档 - KK小铺

00 / START

两种方案都可以

只选其中一种即可，不要同时启用两个相同 Provider。直接配置步骤更少；CC Switch 适合已经用它管理多个服务的人。

OpenCode Desktop 直连

在客户端中创建自定义提供商，逐个填写需要的模型 ID，不依赖 CC Switch。

保留 · 集中管理

CC Switch

下载 CC Switch，通过 Provider JSON 统一管理地址、Key 和模型。

01 / DIRECT

方案 A：OpenCode Desktop 直接配置

适合首次使用或只连接 KK小铺的用户。模型 ID 可从下方列表点击复制，然后逐行添加到客户端。

01

准备 API Key 和模型 ID

先购买并保存完整 API Key，再从本文档“可用模型”区域复制需要的模型 ID。只添加当前 Key 实际支持的模型。

打开购买页面

02

下载 OpenCode Desktop

访问 OpenCode 官方下载页，在 Desktop (Beta) 区域选择当前系统的安装包。macOS 选择 Apple Silicon 或 Intel，Windows 选择 Windows x64，Linux 选择 .deb 或 .rpm。

打开官方下载页

03

打开提供商设置

启动 OpenCode Desktop 并打开项目，点击左下角设置齿轮，然后进入“提供商”。在列表底部找到“自定义提供商”，点击“连接”。

设置 → 提供商 → 自定义提供商 → 连接

04

填写 KK小铺接口

按下面表格填写。基础 URL 必须包含 /v1，提供商 ID 建议使用小写的 kkshop。

字段	填写内容	说明
提供商 ID	`kkshop`	小写字母，不能与已有提供商重复
显示名称	`KK小铺`	仅用于客户端中识别
基础 URL	`https://api.kklt.lol/v1`	必须包含末尾的 /v1
API 密钥	`sk-你的密钥`	填写购买后获得的完整 Key

05

逐行添加模型

在“模型”区域，左侧填写模型 ID，右侧填写显示名称。为避免选错，两栏可以填写相同内容。需要更多模型时点击“添加模型”。

前往模型列表复制 ID

06

保存、选模型并测试

滚动到底部保存或连接。回到会话，从模型选择器进入 KK小铺提供商，选择模型并发送“阅读这个项目并说明目录结构”。能正常返回即配置成功。

安全提醒：API Key 只填写到客户端，不要放进截图、群聊、公开文档或 Git 仓库。

02 / CC SWITCH

方案 B：通过 CC Switch 配置

适合已经用 CC Switch 管理多个 OpenCode Provider 的用户。配置内容根据本文档内的静态模型列表生成。

01

安装 CC Switch 与 OpenCode

先安装 CC Switch 最新稳定版，再安装 OpenCode。完成后启动 CC Switch。

下载 CC Switch

02

启用 OpenCode

打开 CC Switch 设置，在 Apps 或应用管理中勾选 OpenCode，然后返回主界面切换到 OpenCode 标签。

设置 → Apps → OpenCode

03

新增并启用 Provider

点击添加配置或右上角“+”，新建自定义 Provider。复制下方 JSON，把 sk-你的key 替换成自己的 Key，保存并启用。

provider.json

正在根据模型列表生成配置...

不要重复配置：如果已经使用方案 A 连接了 kkshop，请不要再通过 CC Switch 启用同名 Provider。

03 / MODELS

可用模型 ID

以下模型直接写在当前 HTML 中。点击任意模型即可复制；更新时直接编辑这些按钮和首页对应按钮。

04 / API

直接调用 API

KK小铺兼容 OpenAI Chat Completions API，可以在任何支持 HTTP 请求的语言中调用。

Base URLhttps://api.kklt.lol/v1

Chat CompletionsPOST /chat/completions

AuthorizationBearer YOUR_API_KEY

Usage/usage?apikey=YOUR_API_KEY

cURL

curl https://api.kklt.lol/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

选一种方式，连接 OpenCode。