Appearance
计费与支付
系统使用虚拟货币"狐币"（Foxcoins）作为统一计费单位。
计费模型
| 消费类型 | 计费方式 | 说明 |
|---|---|---|
| AI 对话 | 按 Token | 输入/输出 Token 分别计价 |
| 图片生成 | 按任务 | 每个生成器有固定基础费用 |
| 视频生成 | 按任务 | 费用可能按时长变化 |
| 文本生成 | 按 Token | 类似对话计费 |
充值流程
套餐端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/bundles | 套餐列表 |
| GET | /api/v1/bundles/{id} | 套餐详情 |
套餐响应示例
json
{
"id": "a1b2c3d4-...",
"name": "新手套餐",
"price_cents": 990,
"foxcoins": 1000,
"bonus_foxcoins": 200,
"is_active": true
}| 字段 | 说明 |
|---|---|
price_cents | 价格（分），990 = 9.90 元 |
foxcoins | 基础赠送狐币 |
bonus_foxcoins | 额外赠送狐币 |
充值订单端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/payments | 充值订单列表 |
| GET | /api/v1/payments/{id} | 订单详情 |
| PATCH | /api/v1/payments/{id} | 取消/审批订单 |
| POST | /api/v1/payments/wechat/native | 创建微信支付订单 |
交易流水端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/transaction-logs | 交易流水列表 |
| GET | /api/v1/transaction-logs/{id} | 流水详情 |
流水类型
| 类型 | 说明 |
|---|---|
consume_llm | AI 对话消费 |
consume_generation | 内容生成消费 |
refund_generation | 生成失败退款 |
recharge | 充值入账 |
admin_adjust | 管理员手动调整 |
invite_reward | 邀请奖励 |
邀请码端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/invite-codes | 邀请码列表 |
| POST | /api/v1/invite-codes/{code}/bind | 绑定邀请码 |
| GET | /api/v1/invite-codes/{code}/reward-preview | 查看邀请奖励 |
测试要点
测试建议
- 余额扣减准确性：AI 对话消费后余额变化应与 Token 数一致
- 余额不足拦截：对话/生成时余额不足应返回
402 - 失败退款：生成任务失败应自动退还狐币，交易流水中应有退款记录
- 并发扣费：多个操作同时扣费时不应出现超扣
- 支付回调幂等：重复接收相同支付回调不应重复入账
- 订单超时：未支付订单应在一定时间后自动关闭
- 邀请奖励：首次绑定邀请码应发放奖励，重复绑定应拒绝
- 流水完整性：每笔余额变动应有对应的交易流水记录