控制台 API——用 API 查用量、帐务与资源

ATP Token 网页控制台看得到的数据，都有对应的 REST API：https://admin.atptoken.ai/api——即时余额、每月各模型用量、计费活动、模型目录、组织／工作区／项目（project）结构。可用来做仪表板、预算告警、或自动切换模型。

完整且永远与实作同步的规格是线上 Swagger：admin.atptoken.ai/api/docs，以下各页的每个端点都能在那里直接试打。同一份规格也有一份静态、方便 agent 读取的镜像版本，含 operation ID 与型别化参数，发布于 /openapi.json。

认证#

两种凭证，不要混用

atp- API 密钥 只用于数据面（api.atptoken.ai——chat、媒体、embeddings）。控制台 API 使用 POST /api/users/login 取得的 session token（控制台账号密码）。对控制台 API 端点送 atp- 密钥一律回 401，换哪个端点都一样。

请求

curl -sS -X POST https://admin.atptoken.ai/api/users/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"********"}'
# → { "token": "<JWT>", "exp": ..., "user": { ... } }

回传的 token 为 Bearer token，效期约 2 小时。长期执行的脚本遇到 401 应重新登录，不要永久快取 token。POST /api/users/logout 可撤销当前 session。

轮询余额、切换模型#

最常见的整合情境：监看项目即时余额，低于门槛时切换到较便宜的模型。

# 1) Login (console credentials, NOT the atp- API key)
TOKEN=$(curl -sS -X POST https://admin.atptoken.ai/api/users/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"********"}' | jq -r .token)

# 2) Real-time project balance (Redis-backed, reflects every request instantly)
curl -sS "https://admin.atptoken.ai/api/quota/balance?org_id=<org>&workspace_id=<ws>&project_id=<proj>" \
  -H "Authorization: Bearer $TOKEN"

# 3) Current-month usage per model
curl -sS "https://admin.atptoken.ai/api/billing/summary?org_id=<org>" \
  -H "Authorization: Bearer $TOKEN"

查自己的 ID#

多数端点需要 org_id／workspace_id／project_id 查询参数，用以下端点列出：

curl -sS "https://admin.atptoken.ai/api/orgs" -H "Authorization: Bearer $TOKEN"
curl -sS "https://admin.atptoken.ai/api/workspaces?org=<org_id>" -H "Authorization: Bearer $TOKEN"
curl -sS "https://admin.atptoken.ai/api/projects?workspace=<workspace_id>" -H "Authorization: Bearer $TOKEN"

端点分组#

用量与余额——即时余额、每月用量、各密钥用量、趋势、钱包
帐务与充值——计费活动、充值记录、结帐连结、点数调整历史
模型目录——各模态平台级模型清单（chat／image／video／audio／embedding）
资源与成员——组织、工作区、项目、成员、我的账号
请求记录——逐请求观测记录（保留 7 天）

错误#

400

参数缺漏或格式错误（多数端点必带 `org_id`）。

401

session token 缺失／过期，或误用了 `atp-` API 密钥。

403

已认证但无此范围的存取权。

404

可见范围内找不到资源。

下一步

这页有帮助吗？