ガイド更新日:
2026-10-17 の公式 Usage/OpenAPI、Key と請求ヘルプに基づき実装。実アカウントの最小権限、ログイン後の手順、PAYG 単位/計数の照合はユーザーテスト待ちです。代理ログイン、有料リクエスト、権限変更は行っていません。
- 必要な認証情報
- 対象アカウント/チームの通常 Tavily API Key(tvly-)
- 監視単位
- プラン/Key:Credits、PAYG:単位未記載の原値、非通貨(XXX)
- 監視の対象
- アカウントプラン Credits 算出残量 · Key/PAYG は別枠
- 固定 GET https://api.tavily.com/usage のみ、Bearer 認証。本文、X-Project-ID、フィルターなし。tavilyUsage.plan は account.plan_usage/plan_limit、key は key.usage/key.limit から個別に remaining/overage を算出します。現金や全利用可能枠ではなく、PAYG は原値で別表示。金額、percentageRemaining、providerAvailable は null。
Key を預けず使用量を手動確認
- 本人が公式 Dashboard にログインし、業務アカウント/チーム、プランと API keys の Monthly Limit を確認します。
- 既存 Owner が Billing のプラン/PAYG を確認します。有料/チームは側欄 Usage も参照。閲覧不可なら既存担当者に確認を依頼し、昇格/購入しません。
- アカウント、Key、PAYG は各表示単位で別々に比較し合算しません。1 日の計数リセットと購読請求日を区別し、精確な時区を推測しません。
Tavily · アカウントと Key の枠 を Quota Monitor に接続する
対象アカウント/チームと既存プランを確認
公式 Dashboard で業務 Key と同じアカウント/チームを選択し、Billing の既存プランを確認します。個人、チーム、本站プロジェクトは別の範囲です。
チーム Billing は既存 Owner のみ閲覧可能で Admin/Member とは異なりますが、/usage の最小ロールを証明しません。既存アクセスや Key 保管リスクを許容できなければ手動確認とし、昇格/購入しません。
独立した監視 Key を作成
Dashboard の API keys で + を押し、QuotaMonitorUsage などの名前を入力します。既存で許可された種類を選び、完全な tvly- 秘密値を私的に保存します。ID/末尾だけではありません。
Development/Production はレート区分で読み書き権限ではありません。監視のために PAYG やアップグレードが必要な種類を選びません。ログイン後の実際の操作と最小権限は未検証です。
Monthly Limit と権限の境界を確認
作成時の Monthly Limit は API Credits の利用上限で、usage-only scope ではありません。読み取り専用 JSON は確認されず、小さい上限、Development、専用名称でも有料操作が可能です。
既存の安全設定を維持し、業務 Key、PAYG、チームロールを変更せず上限だけ確認します。403 の回避に権限を広げず、厳密な読み取り専用が必要なら通常 Key を預けません。
本站でアカウント/Key 枠を選択
Quota Monitor の対象プロジェクトで接続を追加し、Tavily · アカウントと Key の枠を選び名称を入力します。MCP 安全入力リンクも tavily を使用し、会話/ツール引数に秘密値を送りません。
アカウント/チーム/プロジェクト/Key ID、X-Project-ID、API URL、金銭予算は不要です。XXX は非通貨。本站プロジェクトは上流プランを分割せず、GET /usage のみで有料テストしません。
マスク欄に完全な秘密値だけを保存
安全入力ページのパスワード欄に完全な tvly- Key を貼り保存します。Bearer、URL、Cookie、JSON は付けません。暗号化保管し他画面は末四文字のみ、構文の成功は権限/範囲の証明ではありません。
公開ヘルプは入力を読んだり送信せず、閉じて続行できます。中止時は消去し、秘密のスクリーンショットや重要業務 Key の流用、検索/クロール/Research によるテストは避けます。
初回同期で範囲別に照合
初回同期または枠更新後、新しい成功日時を確認します。account.plan_usage=500、plan_limit=15000 ならプラン算出残量は 14500 Credits。key.usage=150、key.limit=1000 なら Key の算出余地は 850 Credits です。
14500 と 850 は合算せず、現金や確実な利用可能量ではありません。使用が上限を超えると remaining=0、overage は差分で費用ではありません。key.limit=null は当該 Key 上限のみ解除。失敗時は旧値/日時を保持します。
PAYG と月リセットを別々に確認
同じアカウントの Billing で既存 PAYG とプランを別確認します。有料/チームは側欄 Usage も利用でき、無料アカウントにページがなくても購入しません。paygo_usage=25/paygo_limit=100 は単位未記載の原値で、米ドル/Credits や差引 75 の資金とはしません。
ヘルプは Credits/計数のリセットを暦月 1 日とし、購読請求日は別日です。正確な時刻/時区は未報告、resetsAt/timeZone=null。次の UTC 月初、請求日、取得時刻を代入しません。
排錯と専用 Key の安全な交換
401 は完全な tvly- Key、失効、同じアカウントを確認し、403 は既存アクセスを確認し、404 は旧スナップショットを保持して別端点へ迂回せず、429 は待機します。項目欠落や不正形式はゼロ枠ではありません。秘密を含まないコードと日時のみ共有し上流原文は貼りません。
代替監視 Key を作り安全更新後の成功を確認してから古い監視 Key のみ失効させ、他アプリは変更しません。同期のために昇格、PAYG 有効化、入金、有料テストは行いません。
Quota Monitor が取得する Tavily · アカウントと Key の枠 のデータ範囲
- 複数 Key/本站プロジェクトは同じアカウント/チームプランを共有します。重複加算やプラン/Key/PAYG の合計、最小値による利用可能量の推測はしません。
- 明示された key.limit=null のみ単一 Key の上限なしを意味し、アカウント制限は継続します。必須計数の欠落は失敗、0 は実際の上限。remaining/overage は各枠内の算出値でウォレットではありません。
- /usage の paygo_usage は usage count、paygo_limit は usage limit とだけ記載され、Credits/USD 単位は明示されません。not_documented と原整数を維持し、差引・換算せず、Billing や org-usage の独立 USD 項目を流用しません。未報告/null は不明で無制限/無効とは扱いません。
- 公式ヘルプでは Credits/PAYG カウンタは暦月 1 日リセットで購読請求日とは別です。/usage は current billing cycle としつつ期間/時区を返さないため、resetsAt/timeZone=null とし UTC 月初を推測しません。
- 既知の公開プラン名のみ保持し、独自名称や操作/個人/Key 明細は保存しません。Logs、Enterprise org-usage、有料処理、設定変更は呼びません。取得時刻は精算保証ではありません。
- ダッシュボードは最後に成功した额度・支出上限のスナップショットを表示します。更新は供給元の報告遅延を解消できません。失敗後の旧値と時刻は新しい結果でも財布残高でもありません。
Tavily · アカウントと Key の枠 のよくある質問とトラブルシューティング
- 現金残高ですか?
- 違います。プラン/Key は Credits の計数と上限で、残量は同範囲の limit-used 算出値です。現金、返金可能資金、請求費用、全利用可能枠を取得せず金額欄は null です。
- Key 上限なしやプラン残量ゼロの意味は?
- 明示された key.limit=null のみ Key 上限なし、アカウント制限は継続です。PAYG/他制限が別にあるため、プランゼロで全停止は断定しません。0 は無制限でなく、必須項目欠落は失敗です。
- PAYG が米ドル/Credits 表示でない理由は?
- /usage の paygo_usage/paygo_limit は単位が明示されず、原整数のみ表示します。Billing、価格表、org-usage paygo_cost_usd を流用せず、差引/合算/費用推定しません。実単位はユーザーと公式の照合待ちです。
- 正確なリセットのカウントダウンがない理由は?
- ヘルプは暦月 1 日と購読請求日を区別しますが、/usage は billing cycle と記載し期間/時区を返しません。正確な時刻は不明で、UTC 月初や請求日から日付を生成しません。
- 読み取り専用 Key や権限 JSON は設定できますか?
- usage-only scope は未確認です。通常 Key は有料操作可能で、Development/Monthly Limit も読み取り専用ではありません。Enterprise Owner 個人 Key へ範囲を広げず、必要なら手動確認します。
- 401/403/429、旧データや計数差は?
- 完全な Key、対象アカウント/チーム、失効、既存アクセスを確認し 429 は待機します。プラン/Key/PAYG とリセットを区別し旧成功日時を見ます。秘密共有、昇格、PAYG 有効化、有料テストはしません。
Tavily · アカウントと Key の枠 の公式資料
- 公式資料 · docs.tavily.com/documentation/api-reference/endpoint/usage(新しいタブで開きます)
- 公式資料 · docs.tavily.com/documentation/api-reference/openapi.json(新しいタブで開きます)
- 公式資料 · help.tavily.com/articles/9170796666-how-can-i-create-an-api-key(新しいタブで開きます)
- 公式資料 · docs.tavily.com/documentation/best-practices/api-key-management(新しいタブで開きます)
- 公式資料 · help.tavily.com/articles/6846808029-understanding-api-credits-reset(新しいタブで開きます)
- 公式資料 · help.tavily.com/articles/3950309978-understanding-pay-as-you-go-and-billing-resets(新しいタブで開きます)
- 公式資料 · help.tavily.com/articles/7788853762-team-roles-and-permissions-owner-admin-member(新しいタブで開きます)
- 公式資料 · help.tavily.com/articles/7015474742-tavily-usage-dashboard(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。