メインコンテンツへスキップ
GET
リクエスト料金の照会
このエンドポイントは同期 API 呼び出しの料金照会に使用し、主に Chat Completions、Messages、Responses などのインターフェース経由のテキストモデル呼び出しを対象とします。元のレスポンスヘッダー X-Request-Id の値を Request ID として使用します。リクエスト完了後、少し待ってから照会してください。非同期タスクについては、タスク状態の照会 を使用してください。

承認

Authorization
string
header
必須

すべてのエンドポイントで Bearer Token による認証が必要です。

API Key の取得:

API Key 管理ページ にアクセスして API Key を取得してください。

リクエストヘッダーに次の内容を追加してください:

パスパラメータ

request_id
string
必須

元のレスポンスヘッダー X-Request-Id の値を Request ID として指定します。波括弧({})は付けず、パスの末尾に ID をそのまま追加してください。

Maximum string length: 64

レスポンス

照会成功

id
string
必須

Request ID

例:

"20261117223155519063884QnAx70lK"

object
enum<string>
必須

オブジェクトの種類。常に request

利用可能なオプション:
request
例:

"request"

model
string
必須

リクエストで使用したモデル

例:

"claude-haiku-5-5"

status
enum<string>
必須

リクエストの状態:

  • completed:リクエストが正常に完了しました。
  • failed:リクエストが失敗しました。失敗前に使用量が発生していた場合(ストリーミング応答が途中で切断された場合など)、実際に差し引かれた料金を usage に返します。
  • blocked:残高不足、API Key の利用枠の上限到達、API Key の無効化や期限切れ、許可されていないモデルの指定などにより、処理前にリクエストが拒否されました。料金は発生しません。
利用可能なオプション:
completed,
failed,
blocked
例:

"completed"

finished_at
integer
必須

リクエスト終了時刻(Unix タイムスタンプ、秒単位)

例:

1794925917

usage
object
必須

使用量と料金。常に返されます。料金が発生していない場合、すべての値は 0 です。

error
object

失敗の理由。status が failed または blocked の場合にのみ返されます。説明文のみを含み、エラーコードは含みません。エラーコードに基づいて処理する場合は、元のリクエストが返したエラーを使用してください。