计费说明

平台按卡、按分钟计费，计算与存储分别计量。理解这点能避免账单意外。

计费模型

• 单位：内部以微元（micro-CNY，1 元 = 1,000,000 微元）整数记账，避免浮点误差；API 一律以元返回。
• 粒度：按秒累计，约每分钟刷新一次（运行中的实例定期滚动结算，余额耗尽时即时结算）。
• 按卡：实例费率 = 节点单卡价 × 卡数。

费用构成

一个运行中实例的每小时费率 = 计算费 + 存储费：

组成	计费规则
计算（GPU/CPU）	节点 price_per_hour × gpu_count，仅 running 时计
实例存储	全部 disk_gb 按存储费率计（无免费额度），running 与 stopped 都计
独立存储卷 / 快照	按 GB/月单独计费，独立于实例

磁盘按你实际分配的容量整盘计费（默认 10GB，可在租用滑块上调整）；当前计费模型不单独对带宽计费。

停止的影响：实例 stopped 后计算费停止，存储费继续——因为数据还占着节点磁盘。彻底不再付费需销毁实例并删除独立卷。

示例

情形	费率
RTX 4090 × 1，单价 3 元/时，磁盘 10GB	3 元/时 + 10GB 存储费
同上但磁盘 100GB	3 元/时 + 100GB 存储费
上述实例停止后	仅对应磁盘的存储费
A100 × 2，单价 15 元/时，磁盘 50GB	30 元/时 + 50GB 存储费

余额与冻结

启动实例要求余额覆盖至少 1 小时的运行费率，否则 402 INSUFFICIENT_BALANCE。账户字段：

curl -s "$ARK_API/billing/account" -H "Authorization: Bearer $ARK_TOKEN" | jq '.account'

字段	说明
balance	可用余额（元）
frozen	为运行中实例预留
total_spent	累计消费
spending_rate_per_hour	当前总燃烧率（元/时）

费用概览

curl -s "$ARK_API/billing/cost-summary" -H "Authorization: Bearer $ARK_TOKEN" | jq '.summary'

返回 spent_this_month（本月已花）、projected_month_end（预计月末）、burn_rate_per_hour，以及 compute_rate_per_hour / storage_rate_per_hour 的拆分。

账单明细

# 复式账本流水（充值、扣费、退款…）
curl -s "$ARK_API/billing/transactions?page=1&limit=20" -H "Authorization: Bearer $ARK_TOKEN"

# 用量记录
curl -s "$ARK_API/billing/usage?page=1&limit=20" -H "Authorization: Bearer $ARK_TOKEN"

流水 amount 为带符号金额，负数表示扣费。

充值

# 收钱吧（CNY，扫码支付）
curl -X POST "$ARK_API/billing/recharge" \
  -H "Authorization: Bearer $ARK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 100.0 }'

# Stripe（国际卡）
curl -X POST "$ARK_API/billing/recharge/stripe" \
  -H "Authorization: Bearer $ARK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 50.0 }'

收钱吧返回 qr_code（扫码），Stripe 返回 checkout_url（跳转支付）。支付完成后经 webhook 回写订单状态，可轮询 GET /billing/orders/:id。

省钱建议

• 及时停止/销毁：不用就停，长期不用就销毁（注意停止仍计存储费）。
• 控制磁盘：磁盘整盘计费，按需在租用滑块上调小磁盘（最低 10GB）即可省存储费。
• 用竞价实例：能容忍中断的任务用 竞价，价更低。
• 清理卷与快照：闲置的独立卷/快照只要存在就计费，及时删除。