Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content
エンドポイント / Usage

リクエスト詳細

GET/api/usage/requests/{request_id}

完了した request の reconciliation record を取得します。response usage だけでは cache write tokens、provider raw usage、billing line items、routing metadata が足りない場合に使います。

Path parameters

request_idstring
required

同じ API Key が発行した request ID。別 key の request details は読めません。

Response fields

request_idstring

requested request ID。

modelstring

requested model または route name。

resolved_modelstring
nullable

routing/model mapping 後の actual upstream model。

usage.dimensionsobject[]

normalized dimensions。例：input、output、 cache_read、cache_write_5m、 cache_miss。

billing.line_itemsobject[]

price、quantity、total charge を含む billable usage lines。

provider_usage.raw_fieldsobject

reconciliation 用の provider-native usage fields。

routingobject
nullable

request が routing を使った場合の route decision metadata。

Cache field guidance

OpenAI-compatible responses では cache read が

usage.prompt_tokens_details.cached_tokens または usage.input_tokens_details.cached_tokens に出る場合があります。 billing と reconciliation では、この endpoint がより完全な source です。

See also