料金プラン — Shirabe Address API
Pricing — Free / Starter / Pro / Enterprise
全プラン Free 枠 5,000 回/月、超過分から従量課金。
Stripe Billing の transform_quantity 方式で自動集計・請求。
プラン一覧
| プラン | 月間上限 | 単価 | レート制限 | 想定利用 |
|---|---|---|---|---|
| Free | 5,000 回 | ¥0 | 1 req/s | 個人検証、GPTs / Claude / Gemini の動作確認 |
| Starter | 200,000 回 | ¥0.5/回 | 30 req/s | 社内 AI エージェントの日常運用 |
| Pro | 2,000,000 回 | ¥0.3/回 | 100 req/s | SaaS 内部、顧客向け AI 機能の本番運用 |
| Enterprise | 無制限 | ¥0.1/回 | 500 req/s | 大規模バッチ、物流・不動産等の基盤データ化 |
超過分のみ従量課金。例: Starter で月 50,000 回 = (50,000 - 5,000) × ¥0.5 = ¥22,500。
カウントモデル / Counting model
- 単発
/normalize: 1 リクエスト = 1 カウント - バッチ
/normalize/batch: 要素数 N = N カウント - キャッシュヒット / OUTSIDE_COVERAGE: バックエンド呼び出しがスキップされても API カウントには含まれる
- 認証エラー / 400 系エラー: カウントされない(Free 枠を消費しない)
- 503 SERVICE_UNAVAILABLE: カウントされない(障害時の消費を防ぐ)
API キーの発行 / Obtaining an API key
匿名 Free 枠(1 req/s)は API キーなしで利用できます。より高いレート制限や使用量を必要とする場合は、
POST /api/v1/address/checkout で Stripe Checkout を開始し、有料プランの契約と同時に
API キー(プレフィックス shrb_、37 文字)が自動発行されます。
暦 API を既に契約済のユーザーは 同一の API キーで住所 API を呼び出せます(1 キー集約構造)。 プランは API ごとに独立です(例: 暦 Starter + 住所 Free)。
請求と支払い / Billing
- 決済基盤: Stripe Billing(従量課金、
transform_quantity[divide_by]=1000) - 通貨: 日本円(JPY)
- 請求サイクル: 毎月初(Stripe の請求期間に準拠)
- 未払い時: Webhook
invoice.payment_failedを受信した時点でsuspended状態に自動遷移、invoice.payment_succeededで自動復帰 - 解約: Customer Portal から即時解約可能、当月末までサービス利用可