---
title: "請求詳情 API：單次請求的用量、費用與耗時"
description: "依請求 ID 查詢單次請求：標準化的 token 用量、實際扣費、快取欄位和公開耗時。"
source: https://lazu.ai/docs/zh-TW/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"
}
```

## 路徑參數

- `request_id` `string` (必填) — 同一把 API Key 發起的請求 ID。Lazu 不允許讀取其它 key 的請求詳情。

## 響應欄位

- `id` `string` — 請求 ID。
- `model` `string` — 使用者請求的模型或 route 名稱。
- `usage.measurement` `object` (可選) — 分別表示輸入和輸出用量來源：`provider`（上游回報）、`local_estimate`（本地估算）、`unavailable`（無法確定）。歷史或未分類記錄可能沒有此欄位，缺省不能視為上游實測。
- `usage.dimensions` `object[]` — 標準化 usage 維度，例如 `input`、`output`、
  `cache_read`、`cache_write_5m`、
  `cache_write_1h`、`cache_miss`。
- `billing.line_items` `object[]` — 計費明細。
- `routing` `object` (可選) — 僅返回公開狀態和耗時，不暴露內部路由決策及供應商身分。

## Cache 欄位

OpenAI-compatible 響應裡，cache read 可能出現在

`usage.prompt_tokens_details.cached_tokens` 或
`usage.input_tokens_details.cached_tokens`。cache write
只有在上游返回時才會出現。

如果要對帳或排查費用，以請求詳情 API 為準。

## 相關頁面

- [計費規則](https://lazu.ai/docs/zh-TW/billing)
- [模型目錄](https://lazu.ai/docs/zh-TW/models/catalog)
- [Chat completions](https://lazu.ai/docs/zh-TW/endpoints/chat)