レート制限・Tier
リクエストレート制限
| エンドポイント | 制限 | 単位 |
|---|---|---|
/mcp | 60 リクエスト/分 | ユーザーごと |
/oauth/token | 60 リクエスト/分 | IP ごと |
/oauth/register | 10 リクエスト/分 | IP ごと |
/oauth/revoke | 60 リクエスト/分 | IP ごと |
/api/contact | 5 リクエスト/時 | IP ごと |
上記以外の REST API エンドポイント(/api/*)にもレート制限が適用されます。
レート制限を超えた場合は 429 Too Many Requests が返ります。Retry-After ヘッダーにリトライまでの秒数が含まれます。
Tier(プラン)
| Free | Paid | |
|---|---|---|
| プロジェクト数(オーナー) | 3 | 無制限 |
| AI 変換 / 月 | 3 | 300 |
| AI 変換 / 日 | — | 15 |
| プロジェクトメンバー数 | 0(オーナーのみ) | 5 |
AI 変換クォータ
以下の操作は月間の AI 変換クォータを 1 回分 消費します:
- プランの登録(自動的に変換がキューに入る)
- プランの再変換(
POST .../retransform)
利用状況の確認
curl -s -H "Authorization: Bearer $VIDOCS_TOKEN" \
https://nolto.app/api/usage
レスポンス例:
{
"plan": "free",
"transforms": {
"used": 2,
"limit": 3,
"remaining": 1,
"periodStart": "2026-05-01"
}
}
クォータ超過時のレスポンス
月間クォータを超過した状態でプラン登録や再変換をリクエストすると、402 Payment Required が返ります:
{
"error": "月間の AI 変換上限に達しました",
"message": "Free プランの月間上限は 3 回です。上限を引き上げるには Paid プランにアップグレードしてください。",
"upgradeUrl": "/settings/billing"
}
アップグレード
Web UI
ログイン後、設定 → プラン・お支払い からアップグレードできます。
API
# Stripe Checkout セッションを作成
curl -X POST \
-H "Authorization: Bearer $VIDOCS_TOKEN" \
https://nolto.app/api/billing/checkout
レスポンスの url を開くと Stripe の決済画面に遷移します。
Billing Portal
既に有料プランに加入している場合、Stripe のカスタマーポータルでプランの管理・解約ができます:
curl -X POST \
-H "Authorization: Bearer $VIDOCS_TOKEN" \
https://nolto.app/api/billing/portal