用量与账单

JoyToken 会在模型调用成功后记录 tokens、Credits、模型、provider、tier 和 API Key 归因。

你需要看什么

问题看哪里
用了哪个模型X-DAOE-Used-Modelmetadata.model
走了哪个 providerX-DAOE-Used-Provider
消耗多少 Creditsmetadata.billing.credits_used
输入 / 输出 tokenmetadata.billing.input_tokens / metadata.billing.output_tokens
哪把 Key 产生用量JoyToken Console 日志和用量
使用哪个 tiermetadata.tier

响应账单字段

1{
2 "metadata": {
3 "model": "GLM-5",
4 "tier": "standard",
5 "billing": {
6 "credits_used": "0.2288",
7 "input_tokens": 54,
8 "output_tokens": 545
9 }
10 }
11}

流式响应会在 [DONE] 前追加 metadata 事件。

用量归因

建议每个环境和 workflow 使用独立 API Key:

Workflow推荐 Key
本地开发dev-chat-api
生产聊天接口prod-chat-api
Codex / IDEcodex-dev
后台任务worker-summary

控制成本

目标做法
防止测试消耗过高给开发 Key 设置较小预算
控制 Agent 成本Agent / IDE 使用独立 Key 和预算
降低默认成本使用 model: "auto" + tier: "economy"
稳定生产成本固定模型或固定 tier
排查单次调用每次服务端请求带 X-Request-ID

余额不足

402 insufficient_quota 通常来自钱包余额、Key 预算或 tier 余额不足。处理顺序:

  1. 检查个人或组织钱包余额。
  2. 检查请求使用的 tier 是否有余额。
  3. 检查 API Key 的每日/每周预算。
  4. 固定模型失败时,先用 model: "auto" 验证。
  5. premium 成本过高时,尝试 standardeconomy