阿里百炼用量统计代理

---

name: bailian-usage-proxy

description: 阿里百炼大模型平台的多人共享账号用量统计代理服务。用于解决公司共用阿里百炼账号时无法区分个人用量的问题。当用户需要：1) 部署阿里百炼用量统计代理，2) 统计多人Token用量和调用次数，3) 管理大模型API调用配额时激活此技能。

---

# 阿里百炼用量统计代理

为阿里百炼（阿里云大模型服务平台）提供多人共享账号场景下的精细化用量统计方案。

核心能力

使用场景

1. 公司统一申请阿里百炼账号，需要统计每个员工的用量

2. 需要按项目/部门分摊大模型调用成本

3. 需要限制单个用户的日调用配额

快速部署

1. 环境准备

# 克隆或复制本项目
cd bailian-proxy

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入阿里百炼主账号 Key 和数据库配置

2. 数据库初始化

python scripts/init_db.py

3. 启动服务

# 开发模式
python -m app.main

# 生产模式（Docker）
docker-compose up -d

4. 创建用户

python scripts/create_user.py --name "张三" --department "算法部" --daily-limit 1000000

客户端使用

同事只需修改两处配置：

# 原配置
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
api_key = "sk-xxx"  # 阿里百炼的key

# 新配置
base_url = "http://your-proxy-server:8080/v1"
api_key = "internal-key-xxx"  # 代理系统分配的key

查看用量

命令行

# 今日用量
python scripts/usage_report.py --today

# 指定用户
python scripts/usage_report.py --user-key xxx --start 2026-03-01 --end 2026-03-08

# 导出CSV
python scripts/usage_report.py --export usage.csv

管理后台

访问 `http://proxy-server:8081` 查看：

技术架构

详见 [references/architecture.md](references/architecture.md)

API 文档

详见 [references/api.md](references/api.md)

数据库结构

详见 [references/database.md](references/database.md)