充值余额

Superheat 是预付制。余额买的是 GPU 时长和存储，它属于组织而不属于某个人；余额为零或更低时，你既不能部署实例，也不能启动实例。

添加余额

在 cloud.superheat.xyz 的控制台里打开计费。
选择添加余额。
挑一个套餐，或者输入自定义金额。
选择继续付款。你会被交给 Stripe 托管的结账页面。
付款。你会被送回控制台，付款清算后控制台会确认这次充值。

选项	金额
套餐	$10、$25、$100
自定义	$5 到 $1,000 之间的任意金额

余额不会过期。没有订阅，没有开票，也没有后付费：你手上有多少余额，就能花多少。

付完款之后

由 Stripe 确认付款，余额是根据这条确认本身记到你组织账上的——绝不会根据浏览器发来的任何东西。这通常只要几秒，其间控制台显示正在确认付款。

你看到的	它的意思
余额已添加	余额已到账，可以花了
仍在处理中	付款已经成功，余额只是来晚了；余额会自己更新
付款未完成	结账会话已过期，没有产生任何扣款
结账已取消	你在 Stripe 的页面上退出了；没有产生任何扣款

别为一次慢吞吞的确认付两遍钱

如果页面说余额仍在处理中，那付款已经成功了。等余额更新，不要再发起第二次结账。

谁可以充值余额

在一个组织里，充值余额是管理员操作。

操作	管理员	成员
查看余额	是	是
查看交易记录和消费图表	是	是
部署实例并花掉余额	是	是
充值余额并管理支付信息	是	否

成员打开计费页面时，看得到余额、消费图表和完整的交易历史，但添加余额按钮会被一条说明取代，告诉他只有组织管理员才能充值余额或管理支付信息。需要充值的成员只能去找管理员。

在你自己的个人组织里你永远是管理员，所以这一条只有等你加入别人的组织之后才会起作用。参见角色与权限。

余额按组织各自独立

每个组织都有自己的余额和自己的账本。在控制台里切换组织，就切换了你正在看的是哪份余额，以及你下一次部署会从哪份余额里扣。余额不能在组织之间搬来搬去。

余额用光时

余额为零或更低会在新活开始之前就把它拦下：在你充值之前，部署实例和启动一个已停止的实例都会以 INSUFFICIENT_BALANCE 错误失败。已经在跑的实例则由自动停止与自动销毁里讲的那两道自动阈值来处理。

通过 API

curl -X POST "$SUPERHEAT_API/v1/billing/checkout-session" \
  -H "Authorization: Bearer $SUPERHEAT_TOKEN" \
  -H "X-Org-Id: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"pack": "25"}'

pack 接受 "10"、"25"、"100" 或 "custom"。用 "custom" 时还要一并发送 custom_amount_cents —— 一个 500 到 100000 之间的整数，单位是分。响应里带着 checkout_url；在浏览器中打开它即可完成付款。

curl "$SUPERHEAT_API/v1/billing/checkout-session/$SESSION_ID" \
  -H "Authorization: Bearer $SUPERHEAT_TOKEN" \
  -H "X-Org-Id: $ORG_ID"

它返回的 status 是 pending、credited 或 failed，控制台的确认页面轮询的就是这个。

API 密钥买不了余额

shk_ 组织 API 密钥以成员身份行事，所以和其他所有管理员操作一样，它在结账时会被拒绝。创建结账会话需要一个已登录的管理员会话。参见 API 密钥。

添加余额​

付完款之后​

谁可以充值余额​

余额按组织各自独立​

余额用光时​

通过 API​

相关内容​