clovapi

clovapi 是一个共享模型 API 网络。用户创建平台 API Key 后，即可通过统一的 OpenAI 兼容接口选择并调用当前在线的共享模型；无需安装 CLI、配置上游或先贡献 API。

拥有可共享模型资源的用户可以运行 clovapi CLI 作为贡献节点。上游地址和密钥保留在节点本地，平台只接收可用模型 ID，并通过节点的出站连接转发请求与流式响应。

Agent CLI 配置切换与管理已经迁移到 clovagent。

核心能力

• 一套平台 API Key 调用在线共享模型。
• 通过 /v1/models 查看当前可用模型，通过 /v1/chat/completions 或 /v1/responses 发起调用。
• 无需贡献即可使用共享网络；贡献者可通过 CLI 节点增加模型供给。
• 贡献节点自动同步本地可用模型，并可设置每日上限、暂停或断开。
• 节点侧支持 OpenAI、Anthropic、Gemini 等协议适配，上游凭据不会上传到平台。

快速开始

在控制台创建 Consumer API Key，然后查询在线模型：

curl https://api.clovapi.com/v1/models \
  -H "Authorization: Bearer YOUR_CONSUMER_API_KEY"

curl https://api.clovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_CONSUMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_FROM_LIST","messages":[{"role":"user","content":"Hello"}]}'

要贡献你有权共享的模型资源，请安装 CLI，在本地配置 Provider 后运行控制台生成的连接命令：

npm i -g @clovapi/cli
clovapi share start --key YOUR_CLI_CONNECTION_KEY

CLI 会自动同步当前配置目录中的可用模型。完整说明见共享节点。本地代理仍作为贡献节点的执行与协议适配能力保留，也可用于高级本地调用。

目录

Directory	Role
core/	Go CLI、贡献节点执行器、协议适配与 Relay 核心
npm/	npm launcher package (@clovapi/cli)
web/	React + Vite 浏览器管理界面
landing/	clovapi.com 站点

文档

• 日志实现：系统日志和调用日志的触发条件、存储、脱敏与管理方式。
• 智能路由设计
• CLI 共享节点：接入贡献节点并自动同步本地可用模型。
• 在线文档：创建调用凭证、选择共享模型并接入应用。

开发

npm ci --prefix web
npm run dev

打开 http://127.0.0.1:31873，前端支持热更新，Go 修改后自动重新编译并重启服务。生产构建使用 npm run build，不要跳过静态资源构建直接发布 Go 二进制。

cd core
go test ./...

前端检查：npm run check:web。更多说明见 web/README.md。