API Connection Guide
各サービスのAPI制限・接続方法・取得できるデータを詳しく解説します
最終確認日: 2026-03-21（確認者: Kenta）
API制限は予告なく変更される場合がありますKonsumpsyが各サービスから使用量データを取得する際のAPI制限をまとめています
この表は公式ドキュメントをもとに手動で管理しています。 API制限は予告なく変更される場合があります。最新情報は各サービスの公式ドキュメントをご確認ください。
| サービス | 使用量取得 | 必要なキー | レート制限 | 推奨取得頻度 | 備考 |
|---|---|---|---|---|---|
| Claude API | ✓ | Admin APIキー | 120req/分 | 1日1回 | oauth/usageは429多発のため注意 |
| Claude Pro | ✗ | — | — | — | ブラウザ版は取得不可 |
| OpenAI API | ✓ | APIキー | Tier依存（5〜4,000 RPM） | 1日1回 | Tier1以上推奨 |
| ChatGPT Plus | ✗ | — | — | — | ブラウザ版は取得不可 |
| Vercel | ✓ | Access Token | 非公開（実測: 約60req/分） | 1日1回 | |
| GitHub Copilot | ✓ | Personal Access Token | 5,000req/時 | 1日1回 | Org Admin権限必要 |
| Supabase | ✓ | Personal Access Token | 120req/分（標準） | 1日1回 | 重いエンドポイントは10req/分 |
| Cursor | ✗ | — | — | — | API非公開 |
| Windsurf | ✗ | — | — | — | API非公開 |
| Midjourney | ✗ | — | — | — | API非公開 |
| ElevenLabs | △ | APIキー | 非公開（実測: 約30req/分） | 1日1回 | クレジット残量のみ取得可 |
| Perplexity | ✓ | APIキー | Tier依存 | 1日1回 | |
| Manus | ✗ | — | — | — | API非公開 |
すべてのサービスについて 1日1回（UTC 02:00） のバッチで使用量を取得します。 リアルタイム取得は各サービスのレート制限およびKonsumpsyのコスト上の理由から行いません。
注意: 通常の API キーではなく Admin APIキー が必要です。 Role を「Administrator」にしないと Usage API にアクセスできません。
| データ | 取得可否 |
|---|---|
| 月次トークン使用量 | ✓ |
| モデル別使用量（Opus/Sonnet/Haiku） | ✓ |
| 1日単位の使用量推移 | ✓ |
| Claude.ai（ブラウザ版）の使用量 | ✗ |
| 請求額 | ✗（トークン数からの概算のみ） |
Management APIの標準レート制限は 120リクエスト/分 です。
ただし oauth/usage エンドポイントは高頻度アクセスで 429 エラーが多発する既知の問題があります。
Konsumpsy はこのため 1日1回のバッチ取得 のみ実施しています。
Admin APIキーは通常のAPIキーより権限が強いですが、 Konsumpsy は以下の操作のみ実施します:
不要になった場合は Anthropic Console から即時削除できます。
推奨: Usage Tierを確認してください。
- Free / Tier 0: RPM 5（非常に低い）→ 使用量取得に支障が出る場合あり
- Tier 1以上（$5以上の支払い実績）: RPM 500以上 → 安定して取得可能
| データ | 取得可否 |
|---|---|
| 月次トークン使用量（input / output） | ✓ |
| モデル別使用量 | ✓ |
| 1日単位の使用量 | ✓ |
| ChatGPT Plus（ブラウザ版）の会話使用量 | ✗ |
| 請求額 | ✗（概算計算のみ） |
OpenAIのレート制限はアカウントの Usage Tier によって異なります:
| Tier | RPM | TPM |
|---|---|---|
| Free | 3 | 40,000 |
| Tier 1 | 500 | 200,000 |
| Tier 2 | 5,000 | 2,000,000 |
| Tier 3+ | 5,000+ | 4,000,000+ |
Konsumpsyは1日1回のみアクセスするため、Tier 1以上であれば問題ありません。
| データ | 取得可否 |
|---|---|
| プロジェクト数・デプロイ数 | ✓ |
| 帯域使用量 | ✓ |
| Serverless Functions実行時間 | ✓ |
Vercel APIは公式レート制限を非公開としています。 実測では約 60リクエスト/分 程度と確認されています。
Konsumpsyは安全のため 1日1回のみ アクセスします。
| データ | 取得可否 |
|---|---|
| プロジェクト数・稼働状況 | ✓ |
| データベース使用量（接続数・ストレージ） | ✓ |
| APIリクエスト数（Management API経由） | ✓ |
| エンドポイント | レート制限 |
|---|---|
| 標準エンドポイント | 120req/分 |
| 重いエンドポイント（analytics等） | 10req/分 |
Konsumpsyは1日1回のバッチ取得のため、制限に達することはありません。
重要: Copilot使用量の取得には Organization Admin権限 が必要です。 個人プランのCopilotは使用量APIがなく、シート数のみ確認できます。
| データ | 取得可否 |
|---|---|
| Copilot利用シート数（組織） | ✓ |
| アクティブユーザー数 | ✓ |
| コード補完のアクティビティ（集計値） | ✓ |
認証ありの場合: 5,000リクエスト/時（非常に余裕あり）
Konsumpsyは /orgs/{org}/copilot/usage エンドポイントを1日1回のみ呼び出します。
| データ | 取得可否 |
|---|---|
| クレジット残量（使用済み / 上限） | ✓ |
| サブスクリプションプラン名 | ✓ |
| 次回更新日 | ✓ |
| クレジット消費の詳細内訳 | ✗ |
ElevenLabs APIの公式レート制限は非公開です。 実測では約 30リクエスト/分 と確認されています。
Konsumpsyは /v1/user/subscription エンドポイントを1日1回のみ呼び出します。
| データ | 取得可否 |
|---|---|
| API使用量 | ✓ |
| クレジット残量 | ✓ |
| ブラウザ版の使用量 | ✗ |
Perplexity APIのレート制限はアカウントTierにより異なります。
Konsumpsyは1日1回のバッチ取得のみ実施するため、通常の利用では制限に達しません。
Midjourneyは現在、使用量取得のための公式APIを提供していません。
今後APIが公開された場合、Konsumpsyは速やかに対応します。
Cursorは現在、使用量取得のための公式APIを提供していません。
今後APIが公開された場合、Konsumpsyは速やかに対応します。
Windsurfは現在、使用量取得のための公式APIを提供していません。
今後APIが公開された場合、Konsumpsyは速やかに対応します。
APIを持たないサービス（Midjourney等）では使用量欄が「データなし」と表示されます。これは「使っていない」という意味ではありません。
すべてのサービスの使用量は1日1回更新されます。「今日の使用量」をリアルタイムで確認したい場合は、各サービスのダッシュボードを直接ご確認ください。
APIのトークン数から概算した「コスト換算」は、実際の請求額と異なる場合があります。プロモーションクレジット・ボリューム割引・通貨換算レートなどの影響を受けるためです。正確な請求額はProプランの請求書アップロード機能で補完することを推奨します。
KonsumpsyはAPIキーを使用量の「読み取り」のみに使用します。各サービスに付与する権限は最小権限を推奨します。
Konsumpsyは指数バックオフで自動リトライします。リトライ後も取得できなかった場合、前回の値を表示しつつ「データ更新失敗」バッジを表示します。翌日の定期実行で自動回復します。
Q. APIキーを登録すると、Konsumpsyは何ができるようになりますか？
A. 使用量データの読み取りのみです。各サービスへのリクエスト送信、設定変更、解約操作は一切行いません。
Q. APIキーはどのように保管されますか？
A. AES-256方式で暗号化した上でデータベースに保存します。平文で保管・表示されることはありません。
Q. 使用量データの取得頻度を変えられますか？
A. 現在は1日1回固定です。将来のアップデートで変更できるよう検討中です。
Q. APIキーが漏洩した場合はどうすればいいですか？
A. 即座に各サービスのダッシュボードでAPIキーを無効化してください。その後、Konsumpsyのサービス設定からAPIキーを削除・再登録してください。
Q. 対応していないサービスを追加できますか？
A. 手動でサービス名・月額・更新日を登録できます。使用量の自動取得はできませんが、月額管理・更新アラートは機能します。