Appearance
套餐与限额
每个 API Key 绑定一个计费套餐，套餐决定该 Key 的每日限额与每月额度。 实际收款接口已预留（见 计费说明），价格示例不构成报价。
| 套餐 | 日限 | 月限 | 示例定价/月 | 说明 |
|---|---|---|---|---|
free | 100 | 3000 | ¥0 | 体验与开发 |
basic | 1000 | 30000 | ¥199 | 中小产品接入 |
pro | 10000 | 300000 | ¥999 | 高用量产品 |
enterprise | 不限 | 不限 | 定制 | 私有部署/数据隔离 |
限额行为
- 超限返回
429 QUOTA_EXCEEDED（消息含套餐与额度） - 管理端点（
/admin/*）不计入消费额度 - 套餐限额优先于服务默认值（
ATLAS_QUOTA_PER_KEY）
服务方操作
bash
# 签发带套餐的 Key
npx tsx apps/atlas-runtime/src/admin.ts create --product voice --plan pro
# 查看 / 改套餐（立即生效）
npx tsx apps/atlas-runtime/src/admin.ts list
npx tsx apps/atlas-runtime/src/admin.ts set-plan --key key_xxx --plan basic用量与账单
bash
# 用量报表（按产品/Key/端点/状态/天 + 延迟）
npx tsx apps/atlas-runtime/src/admin.ts usage --product voice --days 30
# 月度账单（requests / quota / overage / 示例定价）
npx tsx apps/atlas-runtime/src/admin.ts billing --month 2026-08管理端点（需 Key）：GET /api/atlas/v1/admin/usage?product=&days=、GET /api/atlas/v1/admin/billing?month=。