--- title: Plan と請求 description: 各 plan に含まれるもの、Subako Credit が何に使われるか、そして organization が申し込み、plan を変更し、クレジットを追加購入する方法。 sidebar: order: 7 --- Subako Cloud の請求単位は **Subako Credit (SC)** です。1 ドルで 100 SC なので、SC はどこで使っても 1 セント相当です。商用面で organization が持つものは 2 つあります。何を作成できるか、そして毎月いくつの SC が付与されるかを決める **plan** と、run が引き落とす **クレジット残高** です。 どちらも workspace やメンバーではなく organization に属します。請求関連のコマンドはすべて、サインイン中の profile の organization として動作し、その `admin` role を必要とします。 ## Plan | Plan | 価格 | 付与クレジット | メンバー | Workspace | Agent | Skill | Vault | API key | Model provider | | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | | Free | $0 | サインアップ時に 500 SC を一度 | 1 | 1 | 3 | 5 | 50 | 2 | 2 | | Pro | $19 / 月 | 1,900 SC / 月 | 1 | 3 | 20 | 30 | 500 | 10 | 5 | | Team | $79 / 月 | 7,900 SC / 月 | 5 | 10 | 100 | 150 | 2,000 | 50 | 20 | | Scale | $199 / 月 | 19,900 SC / 月 | 15 | 30 | 300 | 500 | 10,000 | 100 | 50 | 有料 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](/ja/concepts/model-providers) は、上流のキーを用意せずに公開できる 3 つのモデルを提供します。公開時に `--model-provider` でこれを選び、version の設定でモデルを指定します。Sparrow が軽量なもの、Hawk が最大のもので、それぞれ独自のレートを持ちます — 端から端まで最大 20 倍の開きがあるので、version がどのモデルを指定するかが、その session のコストに対する最大のレバーです。 レートは 100 万トークンあたりです。 | モデル | 向いている用途 | 入力 | キャッシュ入力 | キャッシュ書き込み | 出力 | | --- | --- | ---: | ---: | ---: | ---: | | Sparrow (`sparrow`) | 単純で大量の agent タスク | 30 SC | 3 SC | 37.5 SC | 180 SC | | Crow (`crow`) | 日常的なタスク。能力とコストのバランス | 300 SC | 30 SC | 375 SC | 1,800 SC | | Hawk (`hawk`) | 複雑な推論とコーディング | 600 SC | 60 SC | 750 SC | 3,000 SC | 1 ドル 100 SC 換算では、Sparrow の入力 100 万トークンが $0.30、Hawk の出力 100 万トークンが $30 です。同じモデル内では、キャッシュ入力は入力レートの 10 分の 1、キャッシュ書き込みは 1.25 倍です。 レートは固定で、入力が長いからといって高いレートに移ることはありません。自分のキーで登録した [model provider](/ja/concepts/model-providers) 経由の呼び出しは、Subako からはまったく課金されません — あなたが上流に直接支払います。 ### Engine の時間 どの run も、engine がそれを保持した時間に対して、1 秒あたり 0.01388889 SC — 1 時間 $0.50 — で課金されます。モデルがどの provider のものであってもです。この時間は、run の確保が終わったとき — 完了したとき、park したとき、返却されたとき、リースが切れたとき — に台帳に載ります。それまでは未確定なので、実行中の run がまだ支出している間は残高がゼロより上に見えることがあり、終わった時点でマイナスに確定することもあります。 ## クレジットの有効期限 クレジットは **ロット** 単位で届き、ロットごとに独自の有効期限を持ちます。支出は、もっとも早く期限が来るロットから引かれます。 | ロット | 付与 | 期限 | | --- | --- | --- | | サインアップ付与 | 500 SC。1 人につき一度、最初に作成した organization へ | サインアップから 60 日後 | | Plan 付与 | plan の月次 SC。Stripe がサブスクリプションの請求書を支払済みと記録するたびに | その請求書の支払いから 60 日後 | | 購入 | 購入した分 | 購入から 180 日後 | 連続する plan 付与は 1 か月ぶん重なり、使わなかったものは 2 か月で消えます。購入したクレジットは 6 か月もちます。有効期限が延長されることはありません。 ## 残高が尽きたら 残高がゼロ以下の organization は、クレジットが届くまで、あらゆる作成とあらゆる platform モデル呼び出しを 403 で拒否されます。Session のログを読むこと、リソースを一覧すること、すでに作成済みのものはすべて引き続き到達できます。残高は次の支払済みサブスクリプション請求書か、クレジットの購入で戻ります。 ## 申し込む ここでの操作はすべて `subako cloud billing` コマンドで、購入のたびに Stripe がホストするページが開きます。CLI が URL を表示してブラウザを開き、カード情報が Subako を通ることはありません。ページが支払い完了を示した少しあとに Stripe が Subako に支払いを確認し、そのときに plan とその付与が現れます。 1. **organization の現状を見る** ```bash subako cloud billing show ``` Plan、SC 建ての残高、サブスクリプションの状態と期間終了日、登録済みの カードが表示されます。最初の購入より前は、後ろの 2 つは `(none)` と表示されます。 2. **plan に申し込む** ```bash subako cloud billing subscribe --plan pro ``` その plan の Stripe Checkout が開きます。支払いが確認されると organization はその plan になり、最初の月次付与が台帳に載ります。`billing show` はその両方を報告します。 ### Plan を変更する 同じコマンドに別の plan を渡すと、サブスクリプションをその場で変更します。新しい checkout ではなく、変更内容の確認ページ（請求ポータル）が開き、日割り計算と適用日が示されます。 ```bash subako cloud billing subscribe --plan team ``` Stripe は差額の請求書を 1 通発行します。アップグレードでは、その請求書の正味額に相当する SC — 新しい plan の残り月ぶん — が付与されます。ダウングレードでは何も付与されず、何も取り戻されません。 サブスクリプションが正常な状態にない場合、すでに変更が予約されている場合、すでに指定した plan で請求されている場合は、409 で拒否されます。前の 2 つはポータルで解決または確認します。 ### クレジットを購入する ```bash subako cloud billing credits --amount 1000 ``` 1 SC あたり 1 セントの単発購入の Checkout が開きます。最小は 500 SC（$5）、最大は 90,000,000 SC です。クレジットは Stripe が支払いを確認した時点で入金され、180 日後に失効します。 クレジットは Free を含むどの plan でも購入でき、サブスクリプションが終わったあとも使えます。サブスクリプションが加えるのは、月次の付与とより高い上限です。 ### 請求ポータル ```bash subako cloud billing portal ``` Stripe のカスタマーポータルが開きます。ここでカードを変更し、請求書をダウンロードし、サブスクリプションを変更または解約します。何も購入していない間は、開くべき顧客が存在しないため 409 で拒否されます。 ### 支払いが失敗したら Stripe は失敗した更新を独自のスケジュールで再試行します。その間サブスクリプションは `past_due` と表示され、plan は維持されますが、未払いの期間について何も付与されません。再試行が尽きた場合、またはサブスクリプションが解約された場合、organization は Free に戻ります。未失効のクレジットを含め、保持しているものはすべて残り、新しく作るものについて Free の上限が適用されます。あとから支払いが成功すれば plan は復帰します。 ## API から残高を読む Core API の [organization エンドポイント](/ja/api)は、同じ台帳をあなた自身のツールに公開します。`GET /v1/organization/credits` は残高とすべてのロットを返し、各ロットの出所、残量、失効日を含みます。そこでの金額は 1 億分の 1 SC 単位で、1 セント未満の秒単位 engine 時間を表現できる精度です。 :::note 請求は Subako Cloud の機能です。セルフホストのデプロイメントには Stripe も、購入する plan も、`subako cloud billing` コマンドもありません。オペレーターが手動でクレジットを入金します。 :::