钱包接口 /api/wallet

积分余额、流水与调用记录。全部需要登录令牌。

GET /api/wallet

返回余额、最近 50 条流水，以及可用的充值档位。

{
  "ok": true,
  "credits": 992,
  "transactions": [
    { "id": "88", "delta": -8, "balanceAfter": 992, "reason": "调用 nano-banana-2", "model": "nano-banana-2", "createdAt": "..." }
  ],
  "packs": { "5": 1000, "20": 4400, "50": 11500 },
  "sandbox": true
}

每一笔流水都带有 balanceAfter（记账后的余额），因此 users.credits 与流水的累计和始终对得上，可以随时对账。

POST /api/wallet/topup

充值。请求体的 amount 是档位金额（美元），不是积分。

档位（USD）	到账积分
5	1000
20	4400
50	11500

curl -X POST "https://ai.modelfold.online/api/wallet/topup" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":5}'

{ "ok": true, "credits": 1992, "sandbox": true }

当前是沙盒充值

接口直接加积分，不接支付服务商、不会实际扣款。响应里的 sandbox: true 即表示这一点。接入真实支付后，这里会改为「下单 → 支付回调入账」的流程。

不在档位表中的金额返回 400 invalid_pack。

GET /api/wallet/usage

返回最近 100 条调用记录。

{
  "ok": true,
  "requests": [
    { "id": "310", "model": "nano-banana-2", "endpoint": "images", "status": "ok", "credits": 8, "latencyMs": 4310, "error": "", "createdAt": "..." }
  ]
}

字段	说明
status	ok / failed / rejected
credits	成功调用消耗的积分；失败或被拒为 0
error	失败原因，例如 insufficient_credits、upstream_failed

计费规则速查

• 余额不足的请求返回 402，不调用上游、不记账。
• 上游调用失败会自动退款，并记一条 failed 的调用记录。
• 对话模型按真实 token 结算，预扣与实际不一致时自动多退少补。

完整的计费口径见 定价。