購入と課金

組織を有料の Basic または Pro プランにアップグレードする方法、サブスクリプションの管理、 領収書の確認、決済失敗からの復旧について説明します。 料金表の全文は /ja/pricing を参照してください (料金ページが正典です)。

プラン概要

• 価格はすべて USD 表記です。日本在住のお客様には Stripe Tax により消費税 (10%) が加算されます。
• 1 DL token = ceil(model.size / 500MB) です。
• test/public の無料トークン枠は各暦月の開始時 (UTC) にリセットされます。
• mk_live_* (production) と mk_svc_* (agent / CI) のキーには有料プランが必要です。Free tier で発行しようとすると HTTP 402 が返ります。

Basic / Pro へのアップグレード

ダッシュボードから

1. /dash/<slug>/billing を開いてサインインします。
2. Basic / Pro と、月払い / 年払いを選択します。
3. Stripe Checkoutへ進む をクリックします (org が Free tier の間に表示されます)。
4. Stripe Checkout セッションにリダイレクトされるので、そこで支払います。プロモーションコードも利用できます。
5. 支払いが完了するとダッシュボードに戻ります。checkout.session.completed webhook が org を即座に paid に切り替えます — 手動審査はありません。

Upgrade ボタンは次のエンドポイント (セッション認証) を呼び出し、 返された URL にリダイレクトします。

POST /v1/orgs/<slug>/billing/checkout
{ "plan": "basic" | "pro", "interval": "month" | "year" }
→ { "url": "https://checkout.stripe.com/...", "sessionId": "cs_..." }

CLI から

manashiki billing upgrade [--org <slug>]   # ブラウザで Stripe Checkout を開く
manashiki billing status  [--org <slug>]   # 支払い後に tier を確認

--org を省略すると、CLI は manashiki orgs select <slug> で選択中の org を使用します。 支払い後は、キーが即座に production で利用可能になります。現在の CLI の upgrade コマンドは Basic 月払いを開始するため、Pro または年払いはダッシュボードで選択してください。

アップグレードにより mk_live_* と mk_svc_* キーの発行が 可能になり、test/public/live の超過分が token 従量でメータリングされます。 org-private モデルのオンボーディング支援が必要な場合はサポートまでご連絡ください。

サブスクリプションの管理

支払い方法、請求書履歴、解約は Stripe の Customer Portal で行います。 /dash/<slug>/billing から Manage subscription をクリックするか (有料 tier になると表示されます)、CLI を使用します。

manashiki billing portal [--org <slug>]    # Stripe Customer Portal を開く

どちらも次を呼び出します。

POST /v1/orgs/<slug>/billing/portal
→ { "url": "https://billing.stripe.com/..." }

Portal ではカードの更新、過去の請求書の閲覧・ダウンロード、解約ができます。 org が一度も Checkout を行っていない場合、portal の呼び出しは HTTP 409 no_customer を返します。先にアップグレードフローを実行してください。

領収書と請求書

返金について: 初回基本料金は、登録から 7 日以内かつ org の累計 live token が 100 未満であれば全額返金可能です。従量課金分 (metered token) は 返金対象外です。詳細は 特定商取引法に基づく表記 を参照してください。

決済が失敗した場合

1. org の tier が past_due に変わり、決済失敗メールが届きます。 Stripe がサブスクリプションを past_due と報告している間は、既存の mk_live_* / mk_svc_* キーは引き続き機能し、 ダウンロードも中断されず、新規キーも発行できます。この期間は固定タイマーではなく、 Stripe の再試行・督促設定によって決まります。
2. サブスクリプションが未払いのままで Stripe が unpaid または canceled とマークすると、tier は canceled になります。 新規の mk_live_* / mk_svc_* キー発行はブロックされ、 カスタムモデルの利用資格は取り消され、無料の test/public トークン枠に戻ります。
3. キーは 削除されません。org の Stripe customer ID と subscription ID も保持されるため、再開すれば何も作り直すことなく フルアクセスが復元されます。

サービスの復旧

1. Customer Portal を開きます (Manage subscription または manashiki billing portal)。
2. 未払いの請求書を支払うか、支払い方法を更新します。
3. Stripe が支払いを確認すると (invoice.paid)、webhook が 自動的に tier を paid に戻します — サポートへの連絡は不要です。 サブスクリプションが完全に解約済みの場合は、代わりにアップグレードフローを 再実行してください。
4. manashiki billing status または下記の billing status エンドポイントで確認します。

エンタイトルメントの確認

GET /v1/orgs/<slug>/billing/status
→ {
  "tier": "paid",
  "currentPeriodEnd": "2026-07-01T00:00:00.000Z",
  "stagingQuotaUsed": 4,
  "stagingQuotaLimit": null,
  "testTokensThisPeriod": 3,
  "testTokenFree": 100,
  "publicTokensThisPeriod": 0,
  "publicTokenFree": 1000,
  "liveTokensThisPeriod": 312,
  "liveDownloadsThisPeriod": 312,
  "customModelAllowed": true,
  "liveKeyIssuanceAllowed": true,
  "serviceKeyIssuanceAllowed": true,
  "downloadGuardrails": { ... },
  "supportContactMailto": "mailto:..."
}

tier の値:

token allowance、stagingQuotaLimit、ガードレールの limit が null の場合は無制限を意味します。決済を修正したら、 このエンドポイントを再確認 (または billing ページの Refresh をクリック) してください — webhook が届き次第、tier は元に戻ります。

ダウンロードガードレール

ダウンロードは一連のガードレールを通過します。その現在の状態は /dash/<slug>/billing と、status エンドポイントの downloadGuardrails オブジェクトに表示されます。

test/public トークン枠 (Free tier)

Free の org は月 100 test token と 1,000 public token まで利用できます。 1 回のダウンロードは ceil(model.size / 500MB) token です。 無料枠を超えるリクエストは HTTP 402 payment_required を返し、 reason: "test_token_quota_exceeded" または reason: "public_token_quota_exceeded"、現在の使用量、checkout URL が含まれます。アップグレードすると超過分はブロックではなく従量計測されます。

live ダウンロード上限 (自動停止)

有料 org は、課金対象の live ダウンロードに対して期間ごとの上限を設定できます (デフォルトは無制限)。自動停止はデフォルトで有効です: 使用量が上限に達すると live ダウンロードが一時停止され、以降のリクエストは reason: "live_download_cap_reached" 付きの HTTP 402 を返します。 レスポンスには used、limit、 remaining、サポート連絡先が含まれます。一時停止は、 次の請求期間が始まり使用量がリセットされると自動的に解除されます。 status エンドポイントは 50% / 80% / 100% の warning 状態も返すため、 dashboard で自動停止前のリスクを確認できます。

key ごとの live 上限

オペレーターは live key または service key ごとに、任意の月次 live ダウンロード上限を設定できます。key が上限に達すると、org 全体の上限に 余裕があっても、ダウンロード route は reason: "live_key_download_cap_reached" 付きの HTTP 402 を返します。 self-service の key 作成 API は liveDownloadLimit を受け取り、 CLI では production / svc key に --live-download-limit を指定できます。

同時ダウンロード数の制限

各 org が同時に保持できるアクティブな署名付きダウンロード URL は デフォルトで最大 25 個です。超過すると reason: "concurrent_download_limit_reached" 付きの HTTP 429 を返します。クライアントがダウンロード完了後に、download response で 返された requestId を使って lease を解放するか (DELETE /api/download/lease/:requestId)、10 分間の lease バックストップにより自動的にスロットが空きます。これとは別に、 キーごとのダウンロードレート制限も超過時に HTTP 429 を返します。

サービス全体の停止

インシデント発生時、オペレーターはグローバルなキルスイッチを作動させることが できます。その間、すべてのダウンロードは HTTP 503 downloads_suspended を返します。その状態は billing status の killSwitch.enabled で確認できます。

上限、同時実行、停止、キルスイッチのエラーには details にサポート連絡先が 含まれます (free-token 枠の 402 のみ、代わりに checkout URL を含みます)。 制限によってブロックされた場合は contact@utakata-scifi.com までご連絡ください。