儲值餘額
Superheat 是預付制。餘額買的是 GPU 時間與儲存空間,它屬於組織而不屬於個人,而且餘額不足以支付執行個體一小時的費用(它的 GPU 費率加上硬碟的儲存費),再加上組織其他一切一小時的費用時,你既不能部署它,也不能啟動它。
儲值餘額
- 在 cloud.superheat.xyz 的主控台開啟 計費。
- 選擇 儲值餘額。
- 挑一個方案包,或輸入自訂金額。
- 選擇 繼續付款。你會被轉交到 Stripe 託管的結帳頁面。
- 付款。你會回到主控台,付款完成入帳後主控台會確認這次儲值。
| 選項 | 金額 |
|---|---|
| 方案包 | $10、$25、$100 |
| 自訂 | $5 到 $1,000 之間的任意金額 |
餘額不會過期。沒有訂閱、沒有請款單,也沒有後付款:你手上有多少餘額,就只能花多少。
付款之後
Stripe 確認付款,餘額則直接依據那份確認入到你組織的餘額裡 — 絕不會依據瀏覽器送出的任何東西。這通常只要幾秒,這段期間主控台會顯示 確認付款中。
| 你看到什麼 | 代表什麼 |
|---|---|
| 餘額已入帳 | 餘額已儲值完成,可以開始花 |
| 仍在處理中 | 付款已經成功,餘額入帳晚了一點;餘額會自己更新 |
| 付款未完成 | 結帳工作階段逾期,沒有產生任何扣款 |
| 結帳已取消 | 你在 Stripe 的頁面上退出了;沒有產生任何扣款 |
如果頁面顯示餘額仍在處理中,那筆付款早就成功了。請等餘額更新,不要再開一次結帳。
誰可以儲值餘額
在組織內,儲值餘額是管理員才能做的動作。
| 動作 | 管理員 | 成員 |
|---|---|---|
| 查看餘額 | 是 | 是 |
| 查看交易紀錄與花費圖表 | 是 | 是 |
| 部署執行個體並花掉餘額 | 是 | 是 |
| 儲值餘額與管理付款資訊 | 是 | 否 |
成員開啟 計費 頁面時看得到餘額、花費圖表與完整的交易紀錄,但 儲值餘額 按鈕會被換成一段說明,告訴他只有組織管理員能儲值餘額或管理付款資訊。需要儲值的成員只能去找管理員。
在你的個人組織裡你永遠是管理員,所以這件事要等你加入別人的組織之後才有影響。請參閱 角色與權限。
餘額以組織為單位
每個組織都有自己的餘額與自己的帳本。在主控台切換組織,就等於切換你正在看的是哪一份餘額、下一次部署又會從哪一份扣款。餘額無法在組織之間搬移。
餘額用完
餘額不足以支付組織一小時的消耗時,會在新工作開始前就把它擋下來。部署一個執行個體、或在它停止後再次啟動它,需要足以支付組織屆時所有執行項目一小時的餘額——該執行個體的 GPU 與硬碟、其他每個執行中、啟動中或建立中執行個體的 GPU 與硬碟,以及每個已停止執行個體的硬碟。不足的話,就會失敗並回傳 INSUFFICIENT_BALANCE 錯誤,直到你儲值為止。餘額大於零並不夠。錯誤中帶有 balance_micro 與 required_micro,讓你看得出還差多少。至於已經在執行的執行個體,則由 自動停止與自動銷毀 所描述的自動門檻處理。
從 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 是 GET /v1/billing/config 列出的方案包整美元金額("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"
它會回傳 pending、credited 或 failed 其中一種 status,這正是主控台的確認頁面所輪詢的內容。
shk_ 組織 API 金鑰的權限等同成員,所以它在結帳時會像其他所有管理員動作一樣被拒絕。建立結帳工作階段需要已登入的管理員工作階段。請參閱 API 金鑰。