API
计费与余额
计价方式
每个请求按实际 token 用量从余额扣费,没有月费,没有最低充值以外的门槛。
费用 = (输入 × 输入价 + 输出 × 输出价 + 缓存读取 × 缓存读价 + 缓存写入 × 缓存写价) ÷ 1,000,000 实付价 = 官方价 × 倍率(每个模型的倍率见模型页)
- 缓存写入统一按 1 小时档计费(输入价 × 2),缓存读取价见各模型,通常只有输入价的一成或更低。
- 单次请求最低收费 $0.001。
- 请求失败(4xx/5xx、上游不可用、客户端提前断开且没有产生用量)不收费。
- 余额为 0 时新请求返回 402,充值后立即恢复;并发中的请求可能让余额短暂略低于 0。
充值
在控制台「账单与充值」用银行卡、支付宝(Stripe)或 USDT / USDC 稳定币(OxaPay)充值,到账后计入美元余额,订单和流水都可以在同一页查到。
余额查询接口
用 API Key 就能查询余额和这个 Key 最近的请求,适合在脚本或监控里用。
curl https://relient.cfd/v1/billing/balance -H "Authorization: Bearer $TOKENARMY_API_KEY" { "object": "billing.balance", "currency": "USD", "balance_usd": 18.42, "credited_usd": 20, "used_usd": 1.58, "key": { "id": "…", "used_usd": 0.73, "quota_usd": 10 } }
curl "https://relient.cfd/v1/billing/requests?limit=20" -H "Authorization: Bearer $TOKENARMY_API_KEY" { "object": "list", "data": [ { "id": "…", "created_at": "…", "model": "claude-sonnet-5-5", "status": 200, "input_tokens": 1830, "output_tokens": 412, "cache_read_tokens": 0, "cache_create_tokens": 0, "charged_usd": 0.002196, "latency_ms": 2140 } ] }