API クレジット
検索APIはプリペイド制である。アカウントの通貨建てでAPIクレジットの残高を保持し、 課金対象のAPIリクエストごとにそこから差し引かれる。Anthropicスタイルのモデルである: 事前にチャージした残高から、 使った分だけ支払う。サイト上の検索はメンバーシップに含まれ、この残高に触れることは ない — クレジットはAPI専用である。
2つのバケット
残高は独立した2つのバケットの合計である:
| バケット | 出どころ | ライフサイクル |
|---|---|---|
| 含まれる分 | Suede Ultimateの月間割り当て | 各請求期間の開始時にリセット — 残りは繰り越されず失効する。 |
| 購入分 | 購入したクレジット、自動リロード、プロモコード | 繰り越される — 失効もリセットもされない。 |
リクエストはまず含まれる分を、次に購入分を消費する。月間割り当てが常に先に使われ、支払ったクレジットは 後回しになる。差し引きがバケットをゼロ未満にすることはない: 進行中のリクエストは必ず完了し、残高はゼロで止まる。
月間割り当て (Suede Ultimate)
Suede Ultimateには、各期間に1,000 APIリクエスト分のクレジットが含まれ、含まれる分のバケットに投入される。 USDでは**$20.00**である(1,000 × $0.02/リクエスト)。各地域ではその通貨で同等額が付与される。割り当てはメンバー シップの有効化時に付与され、以後は各請求期間の開始時に再付与される。
Suede Proに月間割り当てはない — Proのメンバーは純粋な従量課金でAPIを使い、必要に応じて クレジットを購入する。プランの切り替えは次回の更新時に 適用される: 最初のUltimate期間で割り当てが始まり、最初のPro期間でそれが終わる(残っていた含まれる分は、常の通り 最後のUltimate期間とともに失効する)。
リクエストの料金
課金対象のリクエストは通貨ごとに定額である:
| 通貨 | リクエスト単価 |
|---|---|
| USD | $0.02 |
| GBP | £0.02 |
| EUR | €0.02 |
| CAD / AUD | $0.03 |
| JPY | ¥3 |
| KRW | ₩30 |
残高の確認
- ブラウザで — 設定 → 請求 → APIクレジット(または直接 /account/credits)を開く。合計、各バケット、含まれる分のリセット時期、残高でまかなえる リクエスト数の目安が表示される。
- APIから —
GET /v1/usageを呼ぶ。included_cents、purchased_cents、合計、 推定リクエスト数を返し、クレジットを消費することはない。同じ残高が課金対象のすべてのレスポンスのX-Credits-BalanceとX-Credits-Requests-Remainingヘッダーにも載る。
残高が尽きたら
残高がゼロになると課金対象のエンドポイントは402 insufficient_creditsを返す。対処は
クレジットの追加購入か自動リロードの有効化である。
使用状況の読み取りはゼロでも機能する — GET /v1/usageがクレジットで制限されることはない。