トラブルシューティング

このページの内容

発生している症状に合った項目を順に確認してください。ほとんどの場合、Logs タブが最も早い診断方法です。各リクエストのステータスと失敗のパターン（特定のキーだけか、特定のモデルだけか、すべてか）を確認できます。アクティビティとログを参照してください。

リクエストがブロックされる

すべてのリクエストが 402 `insufficient_credits` で失敗する

原因: この施設でモジュールが有効になっていないか、プリペイド残高が尽きています（Overview タブに "Your balance is depleted. Inference requests will be blocked until you top up." と表示されます）。API キーの場合、モデルルーターが有効になっていない施設では、代わりに 403 "Model Router is not enabled for this facility" が返されます。

解決方法: Welcome to Model Router ページでモデルルーターを有効にし（はじめにを参照）、Budgets & Limits → Balance & Top-up でチャージします。残高が入金されるとすぐにリクエストが再開されます。再発を防ぐには、自動チャージを有効にしてください。予算とチャージを参照してください。

リクエストが 402 `budget_exceeded` で失敗する

原因: 支出上限に達しています。エラーメッセージには、対象の期間（日次 / 月次 / 累計）と、日次と月次の場合はリセットされる正確な日時が施設のタイムゾーンで示されます。アカウント全体の上限の場合もあれば、特定のキーや接続サービスの上限の場合もあります（対象が限定されている場合、メッセージには "This key's" / "This agent's" と表示されます）。

解決方法: 表示されたリセットまで待つか、上限を引き上げる（Budgets & Limits → Spend Limits、またはキーやサービスの設定）か、累計のハードキャップの場合は Reset hard cap を使用します。Spend Limits ページには、どの上限が "Limit reached" になっているかが正確に表示されます。

リクエストが 403 `content_policy_violation` で失敗する

原因: プロンプトが block モードのコンテンツフィルター、またはプロンプトインジェクション対策に一致しました。

解決方法: Settings → Guardrails を確認します。特定の連携に正当な理由で異なるルールが必要な場合は、施設全体のポリシーを緩めるのではなく、その連携の Override facility guardrails トグルを使用してください。ガードレールを参照してください。

リクエストが 429 で失敗する

原因: キーまたは接続サービスが、Requests / min または Tokens / min のレート制限を超えました。

解決方法: 間隔を空けて再試行するか、キーまたはサービスの設定でレート制限を引き上げます（空欄 = 無制限）。API キーを参照してください。

特定のモデルだけがエラーを返し、他は正常に動作する

原因: そのモデルが施設で無効になっているか、キーのモデル制限で除外されているか、プロバイダー側で問題が発生している可能性があります。

解決方法: Settings → Models（有効になっているか）、キーの Restrict models リスト、そして Activity → Performance → Reliability & performance by model でそのモデルのエラー率の推移を確認します。

API キーの問題

401 Unauthorized

原因: コード invalid_api_key（"Missing or invalid API key"）の場合、Authorization: Bearer … ヘッダーがないか、形式が正しくありません。コードがない場合（"Invalid API key"）、キーが不明（入力ミス、または rotate 後の古いシークレット）であるか、revoked（失効）になっています。

解決方法: ヘッダーの形式を確認し、Settings → Service Access & API Keys でキーのステータスを確認します。失効したキーは再有効化し、キーがローテーションされた場合はサービスを新しいシークレットに更新してください。

キーのシークレットを紛失した

シークレットは作成時に一度だけ表示され、復元することはできません。Rotate を使用すると、新しいシークレットが発行され（一度だけ表示されます）、キーのラベル、上限、履歴はそのまま維持されます。そのキーを使用しているすべてのサービスを更新してください: "You will need to reconfigure any services still using the old key."

キーは動作するが、使用量が間違った名前で表示される

Activity と Logs では、キーは Label で識別されます。キーを編集してわかりやすいラベルを設定してください。1 つのキーを共有するのではなく、システムごとに専用のキーを用意してください。

エージェントの問題

エージェントがオフラインと表示される

原因: デバイスの電源が切れているか、接続がありません。これはデバイスの接続性の問題であり、モデルルーターの設定ではありません。

解決方法: デバイスの電源とネットワークを確認します。アクセス設定は影響を受けず、再接続するとすぐに再び機能します。

エージェントが AI リクエストに応答しなくなった

次の順に確認します:

残高: 残高が尽きるとすべてのエージェントがブロックされます（エージェントにはクレジットが必要な状態が表示されます）。チャージしてください。
サービスごとの上限: Settings → Service Access & API Keys → Connected Services で、エージェントに "Limit reached" と表示されていないか確認します。上限を引き上げるか、上限がリセットされるまで待ちます。
アカウントの上限: Budgets & Limits → Spend Limits。
ログ: エージェントで絞り込み、そのリクエストで発生している実際のエラーを確認します。

残高と請求に関する質問

支出の数値が遅れているように見える

利用可能残高 と Spent today の数値はリアルタイムです。Monthly usage は 15 分ごとに残高と照合されるため、ごく最近の支出がそこに反映されるまで数分かかる場合があります。取引履歴にはチャージと残高調整のみが表示されるため、使用量が表示されることはありません。

自動チャージが実行されなかった

Balance & Top-up ページにバナーが表示されていないか確認します。カードが登録されていない、カードの認証が必要、またはカードが拒否された、のいずれかです。カードの問題を解決する（Update card / Edit payment details）か、手動でチャージしてください。自動チャージのチェックはおよそ 15 分ごとに実行されるため、しきい値を下回った直後は実行まで数分かかる場合があります。

チャージに失敗した

"Additional card authentication is required. Please try again.": 再試行してください。銀行から本人確認を求められる場合があります。"Top-up could not be completed.": 決済が拒否されました。カードを確認するか、別の金額でお試しください。決済が成功しない限り、クレジットは付与されません。

請求されたのに残高が変わらない

チャージは即座に反映されます。ページを更新してください。それでも成功した決済が残高に反映されない場合は、取引の詳細ドロワー（またはカードの利用明細）で Transaction ID と Payment reference を控え、サポートリクエストを提出してください。

ログと分析に関する質問

送信したばかりのリクエストがまだ Logs に表示されない

Live 更新をオンにします（または Refresh now をクリックします）。リクエストは通常すぐに表示されますが、負荷が高い場合は少し時間がかかることがあります。

リクエストしていないモデルがログに表示される

model: "auto" を送信した場合、ログには Auto Router が解決したモデルが表示されます。リクエストの詳細を開くと Requested model: auto を確認できます。これは想定どおりの動作です。モデルを参照してください。

行に「No charge」と表示される

コストが発生しなかった失敗または空のレスポンスには No charge バッジが付きます。記録の完全性のために保存されていますが、残高は消費していません。

CSV エクスポートが想定より小さい

生データのエクスポートは 25,000 行が上限です。期間を絞り込むか、サマリーエクスポートを使用してください。また、次の点にも注意してください: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."