## 功能
- **兼容接口**:Chat Completions、Responses、Anthropic Messages 和模型列表,支持流式回复与函数工具调用。
- **多账号调度**:轮询、加权轮询、顺序填满,以及可选的同供应商最早到期优先(FEFO);保留自动选号、会话粘性、并发限制、冷却与故障切换。
- **统一控制台**:管理账号、模型、客户端密钥、代理设置,查看额度和请求日志。
- **华为云码道(实验性)**:OAuth PKCE 登录后直连 snap-access 的 OpenAI 兼容接口,支持流式、工具调用、按目录声明向视觉模型转发图片、按目录声明的 reasoning 档位,并读取套餐积分 / token 计量。
- **Docker 运维**:持久化账号数据;可选安装宿主机更新器,在控制台下载更新、确认升级和回滚。
Qoder 国内版、WorkBuddy、Trae 的适配代码已实现,真账号验收仍未完成;Devin、Command Code 与华为云码道 CodeArts 为实验性接入,不承诺生产可用。托管更新的真实升级 / 回滚验收也尚未完成。Kimi Code(中国区)已完成单账号端到端验收:设备码登录、模型发现、三种接口的对话 / 流式 / 工具调用 / 视觉,以及额度读取;多账号行为只有自动化测试覆盖。码道 CodeArts 已完成单账号端到端验收:OAuth 登录、模型发现与不可用模型剔除、Chat Completions / Anthropic Messages / Responses 的非流式与流式、工具调用、reasoning 透传、套餐额度读取和签到;双账号失败切换与会话粘性也已实测,额度耗尽切换仍待验收。
## 快速开始
需要 Docker 和一个你自己控制的上游账号。macOS / Windows 使用 Docker Desktop;Windows 需使用 Linux containers。
```bash
git clone https://github.com/caigee-cmd/cli2api.git
cd cli2api
./scripts/start.sh # Windows 用 scripts\start.ps1
```
1. 保存首次启动日志中打印的**管理员密钥**。
2. 打开 `http://127.0.0.1:3010`,用管理员密钥登录,在 **Accounts** 添加账号。
3. 在 **API keys** 创建客户端密钥,在 **Access** 选择模型并测试。
Docker Compose 是支持的安装与托管更新路径;源码运行用于开发。详细步骤见 [部署说明](deploy/README.md)。
## 接入客户端
在支持 OpenAI 兼容 API 的客户端中填写:
```text
Base URL: http://127.0.0.1:3010/v1
API Key: <在 API keys 页面创建的客户端密钥>
```
模型 ID 从 **Access** 页面或 `/v1/models` 获取。默认自动选择账号,同一对话优先复用原账号。固定账号、自定义会话标识及 curl / PowerShell 示例见 [部署说明](deploy/README.md)。
## 工作方式