リクエスト証跡
リクエスト単位の記録を使って、パフォーマンスと利用額を把握します。
リクエストログには、API 呼び出しごとのステータス、モデル、使用量、レイテンシ、コストの情報が保存されます。リクエスト ID を使うと、問題の箇所を特定し、API レスポンスとコンソール上の記録を照合できます。
リクエストを探す
- コンソールでリクエストログを開きます。
- API を呼び出した日時を含む期間を選択します。
- モデル、ステータス、API キーなど、利用可能なフィルターを使用します。
- 該当する記録を開いて詳細を確認します。
タイムゾーンをまたいでアクティビティを確認する場合は、まずページに表示されている日時とタイムゾーンを確認してください。
記録のフィールド
| フィールド | 用途 |
|---|---|
| リクエスト ID | プラットフォーム上の 1 件のリクエストを特定します |
| 日時 | リクエストを探したり、呼び出しの順序を確認したりするのに役立ちます |
| Model ID | 呼び出しに使用されたモデルを示します |
| ステータス | 完了、失敗、処理中のリクエストを区別します |
| 入力と出力の使用量 | トークンなどの計量情報を示します |
| レイテンシ | リクエストの処理時間を示します |
| コスト | リクエストの金額と精算状態を示します |
HTTP ステータスが常に最終的な精算状態を表すとは限りません。また、「コストが表示されない」「コストがゼロ」「コストが未精算」も、それぞれ異なる状態を表している可能性があります。
コストが想定より高い場合
- 実際の Model ID と料金単位を確認します。
- 長い会話履歴、画像、大きな出力が含まれていないか確認します。
- キャッシュ、メディアなど、別途計量される項目を確認します。
- アプリケーションや SDK が再試行して、追加のリクエストを作成していないか確認します。
- サポートに問い合わせる前に、リクエスト ID とマスク済みのエラー詳細を控えておきます。
記録が見つからない場合
アカウント、ワークスペース、期間、タイムゾーン、フィルターを確認してから、ページを更新してください。記録がまだ表示されていなくても、使用量が発生していないとは限りません。記録を作成するためだけに同じリクエストを再送信しないでください。
サポートに問い合わせる際は、リクエスト ID、日時とタイムゾーン、Model ID、ステータスコード、マスク済みのエラーを伝えてください。API キー全体や機密性の高いリクエスト内容は提供しないでください。