購入と課金

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

プラン概要

プラン	月額基本料金	含まれる内容
Free	$0	staging DL 10 回 / 月、first-party カタログへのアクセス、`mk_test_*` キー 1 個、監査ログ 30 日
Developer	$15 / 月	production DL 1,000 回込み、超過分は $0.001 / DL。staging DL はローンチ時点で無制限 (将来的に 1,000 回込み + $0.0005 / DL の超過課金を予定)。カスタムモデル 5 個、ストレージ 10 GB、`mk_svc_*` キー 5 個、監査ログ 90 日
Enterprise	個別見積	ボリューム DL 価格、99.9% SLA + 専用 R2 バケット、SSO (SAML / OIDC)、監査ログ最長 7 年

価格はすべて USD 表記です。日本在住のお客様には Stripe Tax により消費税 (10%) が加算されます。
1 DL = GET /api/download/:modelId の成功レスポンス 1 回です。
staging クォータは各暦月の開始時 (UTC) にリセットされます。
mk_live_* (production) と mk_svc_* (agent / CI) のキーには有料プランが必要です。Free tier で発行しようとすると HTTP 402 が返ります。

Developer へのアップグレード

ダッシュボードから

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

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

POST /v1/orgs/<slug>/billing/checkout
→ { "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 で利用可能になります。

アップグレードにより mk_live_* と mk_svc_* キーの発行が可能になり、staging クォータが解除され、org がカスタム (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 を返します。先にアップグレードフローを実行してください。

領収書と請求書

請求書は Stripe が発行します。すべての請求書には hosted invoice ページとダウンロード可能な PDF があり、Customer Portal から利用できます。

加えて、サービスから org の連絡先アドレス宛にメールを送信します (未設定の場合は Stripe customer のメールアドレスにフォールバック。現行リリースで順次展開中)。

領収書 — 請求書の支払い完了時。支払額、請求書番号、hosted invoice リンク、PDF リンクを含みます。
決済失敗通知 — 請求の失敗時。請求額、7 日間の猶予期間の説明、支払いまたは支払い方法更新へのリンクを含みます。

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

決済が失敗した場合

org の tier が past_due に変わり、決済失敗メールが届きます。 7 日間の猶予期間 があり、その間は既存の mk_live_* / mk_svc_* キーは引き続き機能し、ダウンロードも中断されません。ただし、org が paid に戻るまで、 新規の mk_live_* / mk_svc_* キー発行は HTTP 402 を返します。
サブスクリプションが未払いのままで Stripe が unpaid または canceled とマークすると、tier は canceled になります。新規の mk_live_* / mk_svc_* キー発行はブロックされ、カスタムモデルの利用資格は取り消され、staging クォータは 10 回 / 月に戻ります。
キーは 削除されません。org の Stripe customer ID と subscription ID も保持されるため、再開すれば何も作り直すことなくフルアクセスが復元されます。

サービスの復旧

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

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

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

tier の値:

Tier	意味
`free`	サブスクリプションなし。staging のみ、10 DL / 月。
`paid`	Developer サブスクリプションが有効。すべてのゲートが開放されています。
`past_due`	決済失敗。7 日間の猶予期間中 — 既存キーは機能し続けますが、新規の live / service キー発行は停止されます。
`canceled`	サブスクリプション終了または未払い。live / service キーの発行とカスタムモデルは停止、staging クォータは 10 回 / 月に戻ります。
`enterprise`	個別契約。

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

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

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

staging クォータ (Free tier)

Free の org は月 10 回まで staging ダウンロードが可能です。11 回目のリクエストは HTTP 402 payment_required を返し、 reason: "staging_quota_exceeded" と現在の使用量、 checkout URL が含まれます。アップグレードするとクォータは即座に解除されます。

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

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

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

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

サービス全体の停止

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

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