管理接口（/admin/*，仅内部）
供网关运营方使用，不对客户开放。日常操作建议走 admin console（浏览器），接口用于脚本化与应急。
鉴权
两种方式，二选一：
- Admin API key：
Authorization: Bearer $AI_GATEWAY_ADMIN_API_KEY（支持多 key，逗号分隔配置）。用于脚本。 - Session cookie：
POST /admin/auth/login用户名密码登录，签发 HttpOnly cookie。admin console 走这条，key 不进前端。
接口分组
认证会话
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /admin/auth/login | 用户名密码换 session cookie |
| GET | /admin/auth/me | 当前会话状态 |
| POST | /admin/auth/logout | 注销会话 |
企业与密钥
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /admin/organizations | 创建企业（name + slug） |
| GET | /admin/organizations | 企业列表（含余额、活跃密钥数） |
| POST | /admin/api-keys | 签发 agw_ key（组织 + scopes + 可选 RPM/TPM），明文仅创建时返回一次 |
| GET | /admin/api-keys | 密钥列表（不含明文） |
| DELETE | /admin/api-keys/{key_id} | 吊销密钥 |
额度
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /admin/credits | 充值/调减（微元；正数充值，负数调减） |
| GET | /admin/credits | 额度流水（按组织过滤） |
能力目录与定价
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /admin/capabilities | 能力就绪状态（能力 × 活跃模型 × 活跃线路 × 缺失 env） |
| GET / POST | /admin/models | 对外模型目录查询 / upsert（按 alias） |
| GET / POST | /admin/model-deployments | 供应商线路查询 / upsert（优先级、权重、限流、凭证 env 引用） |
| GET / POST | /admin/pricing | 价格目录查询 / upsert（对外价挂能力级；供应商成本行按 provider 区分） |
用量与账单
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /admin/usage-events | 逐笔用量事件（含 user 标签、路由尝试、成本/售价快照） |
| GET | /admin/usage-summary | 按企业 × 产品 × 模型聚合 |
| GET | /admin/statements?organization_id=&month=YYYY-MM | 月度结算单 JSON（四项余额、产品明细、 人级明细、勾稽标志） |
| GET | /admin/statements/export | 同上，CSV（UTF-8 BOM），随发票交付客户 |
总览
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /admin/overview | console 首页聚合（企业数、密钥数、近期请求等） |
出账示例
# 月度结算单 JSON
curl "$GW/admin/statements?organization_id=<org_id>&month=2026-07" \
-H "Authorization: Bearer $AI_GATEWAY_ADMIN_API_KEY"
# CSV（交付客户）
curl -OJ "$GW/admin/statements/export?organization_id=<org_id>&month=2026-07" \
-H "Authorization: Bearer $AI_GATEWAY_ADMIN_API_KEY"