Plan と請求

各 plan に含まれるもの、Subako Credit が何に使われるか、そして organization が申し込み、plan を変更し、クレジットを追加購入する方法。

Subako Cloud の請求単位は Subako Credit (SC) です。1 ドルで 100 SC なので、SC はどこで使っても 1 セント相当です。商用面で organization が持つものは 2 つあります。何を作成できるか、そして毎月いくつの SC が付与されるかを決める plan と、run が引き落とす クレジット残高 です。

どちらも workspace やメンバーではなく organization に属します。請求関連のコマンドはすべて、サインイン中の profile の organization として動作し、その admin role を必要とします。

Plan

有料 plan はいずれも、ドル建ての価格と同じ額面の SC を付与します。Session はどの plan でも無制限です。

CLI 上では有料 plan は pro、team、scale です。Free は default で、一度も申し込んでいない organization について billing show が報告するのがこれです。

上限の意味

上限は、organization がすべての workspace を通じて保持できる数を制限します。次のひとつを作成しようとしたときに検査され、その上限を示す 403 で作成が拒否されます。すでに作成済みのものには手が加わりません — 小さい plan に移った organization は持っているものをすべて保ち、上限を下回るか大きい plan に移るまで、新しく追加できなくなるだけです。

メンバー数は、参加済みの人だけでなく保留中の招待も数えます。Vault、skill、model provider を削除すると枠が空き、API key を取り消すか失効させた場合も同様です。Model provider の上限が数えるのは、自分のキーで登録した provider です。Subako の platform provider はそこに含まれません。

クレジットは何に使われるか

残高を引き落とすものは 2 つあります。Subako 自身の platform モデルへの呼び出しと、run が使う engine の時間です。

Platform モデル

Subako Cloud の Subako platform provider は、上流のキーを用意せずに公開できる 3 つのモデルを提供します。公開時に --model-provider でこれを選び、version の設定でモデルを指定します。Sparrow が軽量なもの、Hawk が最大のもので、それぞれ独自のレートを持ちます — 端から端まで最大 20 倍の開きがあるので、version がどのモデルを指定するかが、その session のコストに対する最大のレバーです。

レートは 100 万トークンあたりです。

1 ドル 100 SC 換算では、Sparrow の入力 100 万トークンが $0.30、Hawk の出力 100 万トークンが $30 です。同じモデル内では、キャッシュ入力は入力レートの 10 分の 1、キャッシュ書き込みは 1.25 倍です。

レートは固定で、入力が長いからといって高いレートに移ることはありません。自分のキーで登録した model provider 経由の呼び出しは、Subako からはまったく課金されません — あなたが上流に直接支払います。

Engine の時間

どの run も、engine がそれを保持した時間に対して、1 秒あたり 0.01388889 SC — 1 時間 $0.50 — で課金されます。モデルがどの provider のものであってもです。この時間は、run の確保が終わったとき — 完了したとき、park したとき、返却されたとき、リースが切れたとき — に台帳に載ります。それまでは未確定なので、実行中の run がまだ支出している間は残高がゼロより上に見えることがあり、終わった時点でマイナスに確定することもあります。

クレジットの有効期限

クレジットは ロット 単位で届き、ロットごとに独自の有効期限を持ちます。支出は、もっとも早く期限が来るロットから引かれます。

連続する plan 付与は 1 か月ぶん重なり、使わなかったものは 2 か月で消えます。購入したクレジットは 6 か月もちます。有効期限が延長されることはありません。

残高が尽きたら

残高がゼロ以下の organization は、クレジットが届くまで、あらゆる作成とあらゆる platform モデル呼び出しを 403 で拒否されます。Session のログを読むこと、リソースを一覧すること、すでに作成済みのものはすべて引き続き到達できます。残高は次の支払済みサブスクリプション請求書か、クレジットの購入で戻ります。

申し込む

ここでの操作はすべて subako cloud billing コマンドで、購入のたびに Stripe がホストするページが開きます。CLI が URL を表示してブラウザを開き、カード情報が Subako を通ることはありません。ページが支払い完了を示した少しあとに Stripe が Subako に支払いを確認し、そのときに plan とその付与が現れます。

subako cloud billing show

subako cloud billing subscribe --plan pro

Plan を変更する

同じコマンドに別の plan を渡すと、サブスクリプションをその場で変更します。新しい checkout ではなく、変更内容の確認ページ（請求ポータル）が開き、日割り計算と適用日が示されます。

subako cloud billing subscribe --plan team

Stripe は差額の請求書を 1 通発行します。アップグレードでは、その請求書の正味額に相当する SC — 新しい plan の残り月ぶん — が付与されます。ダウングレードでは何も付与されず、何も取り戻されません。

サブスクリプションが正常な状態にない場合、すでに変更が予約されている場合、すでに指定した plan で請求されている場合は、409 で拒否されます。前の 2 つはポータルで解決または確認します。

クレジットを購入する

subako cloud billing credits --amount 1000

1 SC あたり 1 セントの単発購入の Checkout が開きます。最小は 500 SC（$5）、最大は 90,000,000 SC です。クレジットは Stripe が支払いを確認した時点で入金され、180 日後に失効します。

クレジットは Free を含むどの plan でも購入でき、サブスクリプションが終わったあとも使えます。サブスクリプションが加えるのは、月次の付与とより高い上限です。

請求ポータル

subako cloud billing portal

Stripe のカスタマーポータルが開きます。ここでカードを変更し、請求書をダウンロードし、サブスクリプションを変更または解約します。何も購入していない間は、開くべき顧客が存在しないため 409 で拒否されます。

支払いが失敗したら

Stripe は失敗した更新を独自のスケジュールで再試行します。その間サブスクリプションは past_due と表示され、plan は維持されますが、未払いの期間について何も付与されません。再試行が尽きた場合、またはサブスクリプションが解約された場合、organization は Free に戻ります。未失効のクレジットを含め、保持しているものはすべて残り、新しく作るものについて Free の上限が適用されます。あとから支払いが成功すれば plan は復帰します。

API から残高を読む

Core API の organization エンドポイントは、同じ台帳をあなた自身のツールに公開します。GET /v1/organization/credits は残高とすべてのロットを返し、各ロットの出所、残量、失効日を含みます。そこでの金額は 1 億分の 1 SC 単位で、1 セント未満の秒単位 engine 時間を表現できる精度です。