用途：帮助理解 OpenRouter 的计费方式，估算与核对请求成本，并在预算、比价和跟踪支出时优化花费。
计费方式：按 token 计费，prompt（输入）与 completion（输出）费率分开；models API 中价格以每 token 列出，乘以 100 万得到每百万 token 费率。额度为预付费，收取 5.5% 手续费（最低 $0.80）。免费模型可用于测试和低量使用。每次请求扣费为 (prompt_tokens * prompt_rate) + (completion_tokens * completion_rate)。
主要能力：用 GET /api/v1/models 查询各模型每 token 费率；用 estimate_cost() 在提交前估算花费；请求后用 GET /api/v1/generation?id= 获取精确费用；用 GET /api/v1/auth/key 查看余额与限额；用 :floor 变体选最便宜提供商，用 :free 变体使用免费提供商。
使用前提：需要 OpenRouter API key（sk-or-v1-...）并导出为 OPENROUTER_API_KEY；查询价格与余额需 curl 和 jq；成本计算与生成端点示例需 Python 3.8+、OpenAI SDK 和 requests 包；付费模型需预付费额度，公开的 models/pricing 端点无需认证，但真实补全需要额度或 :free 模型。
特殊计费：推理 token 按输出费率计费；图像输入按 pricing.image 中列出的每图费用；部分模型收取每请求固定费用（pricing.request）；BYOK 每月前 100 万次请求免费，之后按正常提供商成本的 5%；免费模型限制为免费用户每天 50 次请求，持有 $10 以上额度者每天 1000 次。
限制与错误：额度不足或达到 key 限额会返回 HTTP 402，需在 openrouter.ai/credits 充值或改用 :free 模型。生产环境可设置每 key 额度上限、启用自动充值，并为每次请求设置 max_tokens 以限制输出成本。