---
title: "リクエスト詳細 API：1 件ごとの使用量・料金・所要時間"
description: "リクエスト ID で 1 件のリクエストを照会：正規化されたトークン使用量、実際の請求額、キャッシュ項目、公開タイミング。"
source: https://lazu.ai/docs/ja/endpoints/usage-requests
updated: 2026-10-02
---

# リクエスト詳細

**GET** `/api/usage/requests/{request_id}`

完了したリクエストの使用量、請求明細、公開タイミングを確認します。

## リクエスト例

```bash
curl https://api.lazu.ai/api/usage/requests/req_lazu_01ABCDEF \
  -H "Authorization: Bearer $LAZU_API_KEY"
```

## レスポンス例

```json
{
  "object": "usage.request",
  "id": "req_lazu_01ABCDEF",
  "created_at": 1765980000,
  "model": "gpt-6-luna",
  "endpoint": "/v1/chat/completions",
  "usage": {
    "prompt_tokens": 1200,
    "completion_tokens": 300,
    "total_tokens": 1500,
    "dimensions": [
      { "name": "input", "quantity": 1200, "unit": "token" },
      { "name": "cache_read", "quantity": 300, "unit": "token" },
      { "name": "output", "quantity": 300, "unit": "token" }
    ]
  },
  "billing": {
    "currency": "USD",
    "amount_microusd": 480,
    "pricing_version": 3,
    "line_items": [
      {
        "dimension": "input",
        "quantity": 1200,
        "unit_microusd": 150,
        "amount_microusd": 180
      }
    ]
  },
  "routing": {
    "status_code": 200,
    "total_duration_ms": 1840,
    "ttft_ms": 420,
    "was_streaming": true
  },
  "provider_usage": {
    "family": "openai",
    "raw_fields": { "prompt_tokens": 1200, "completion_tokens": 300 }
  },
  "log_id": "log_01ABCDEF"
}
```

## Path parameters

- `request_id` `string` (必須) — 同じ API Key が発行した request ID。別 key の request details は読めません。

## Response fields

- `id` `string` — requested request ID。
- `model` `string` — requested model または route name。
- `usage.measurement` `object` (任意) — 入力と出力それぞれの根拠です。`provider` は報告値、`local_estimate` はローカル推計、`unavailable` は不明です。過去の記録などでは省略されます。省略を実測値の証拠と解釈しないでください。
- `usage.dimensions` `object[]` — normalized dimensions。例：`input`、`output`、
  `cache_read`、`cache_write_5m`、
  `cache_miss`。
- `billing.line_items` `object[]` — price、quantity、total charge を含む billable usage lines。
- `routing` `object` (任意) — 公開ステータスとタイミングのみ。内部ルーティング判断やプロバイダーの識別情報は公開しません。

## 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

- [料金体系](https://lazu.ai/docs/ja/billing)
- [モデルカタログ](https://lazu.ai/docs/ja/models/catalog)
- [Chat completions](https://lazu.ai/docs/ja/endpoints/chat)