快捷测试
尚未发送请求
请求趋势 最近 30 分钟
模型调用分布
最近请求
| 时间 | 模型 | 类型 | 状态 | 延迟 | Token | 错误 |
|---|
接入方式
兼容 OpenAI 协议。客户端填 Base URL /v1,API Key 填面板「密钥」页生成的任意一把(未创建密钥时不校验)。
模型清单
| 模型 | 通道 | 请求 | 成功率 | 平均延迟 | Token | 最近调用 | 操作 |
|---|
请求日志
| 时间 | 模型 | 推理强度 | 会话 ID | 模式 | 结果 | 耗时 | 首字 | 速度 | 输入 | 输出 | 思考 | 缓存 | 总 Token | 密钥 | 来源 | 错误 |
|---|
新建密钥
创建后 /v1/* 立即开启鉴权:客户端用 Authorization: Bearer <key> 或 x-api-key。停用全部密钥则接口重新开放。
密钥列表
| 名称 | 密钥 | 状态 | 请求 | Token | 失败 | 创建时间 | 操作 |
|---|
网关设置
出口代理池
| 状态 | 出口 | 请求 | 成功 | 429 | 失败 | 冷却 | 最近错误 | 操作 |
|---|
作用于全部出站请求:聊天转发、模型目录、版本探测。相同地址与账号会自动去重;不写协议默认 http。
熔断中的出口会跳过,全部熔断时用最早解冻的那个半开放行,不会整站断流。
会话身份
四个会话头必须同值;会话 ID 前缀是时间编码(降序),上游会解码校验。会话频繁重建会触发按会话计的 429,因此全程复用。
危险操作
运行信息
PC 端(Windows / Linux)
# Windows:双击或在终端运行 oc2a-windows-amd64.exe -listen 0.0.0.0:8585 -open # Linux:注册为 systemd 服务 sudo install -m755 oc2a-linux-amd64 /usr/local/bin/oc2a sudo oc2a -listen 0.0.0.0:8585 -data /var/lib/oc2a # 或使用仓库内 deploy/oc2a.service
不带参数也能跑,配置与统计默认落在可执行文件旁的 data/ 目录。
Android(Magisk / KernelSU)
# 1) 手机 root 后,把模块 zip 推到设备 adb push oc2a-magisk-arm64.zip /sdcard/ # 2) Magisk:模块 → 从本地安装 → 选择 zip # KernelSU:模块 → 安装 → 选择 zip(同一份 zip 通用) # 3) 重启后在手机浏览器打开 http://127.0.0.1:8585/ # 常用运维(模块内置脚本) su -c 'sh /data/adb/modules/opencode2api/oc2a.sh status' su -c 'sh /data/adb/modules/opencode2api/oc2a.sh restart' su -c 'sh /data/adb/modules/opencode2api/oc2a.sh log'
数据目录固定在 /data/adb/opencode2api,卸载模块不会删除配置。二进制为静态链接的 linux/arm64,不依赖 Python 与任何运行时。
端点
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/chat/completions | OpenAI 兼容转发,支持 stream / 非 stream |
| GET | /v1/models | 免费档可用模型列表 |
| GET | /health | 存活探针,返回 OK |
| GET | / | 本控制台 |
环境变量
| 变量 | 等价参数 | 说明 |
|---|---|---|
| OC2A_LISTEN | -listen | 监听地址,默认 0.0.0.0:8585 |
| OC2A_DATA | -data | 数据目录 |
| OC2A_PASSWORD | -password | 面板密码 |
| OC2A_API_KEY | -api-key | /v1 密钥,首次启动写入密钥列表(名为 env) |
| OC2A_CLIENT_VERSION | -client-version | 固定上报版本,跳过 npm 探测 |