---
title: "请求详情 API：单次请求的用量、费用与耗时"
description: "按请求 ID 查询单次请求：标准化的 token 用量、实际扣费、缓存字段和公开耗时。"
source: https://lazu.ai/docs/zh/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`、audio/image 维度等。
- `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 只有在上游返回时才会出现，字段可能是

`cache_write_tokens`、`cache_write_5m_tokens` 或
`cache_write_1h_tokens`。

如果要对账或排查费用，以请求详情 API 为准。

## 相关页面

- [计费规则](https://lazu.ai/docs/zh/billing)
- [模型目录](https://lazu.ai/docs/zh/models/catalog)
- [Chat completions](https://lazu.ai/docs/zh/endpoints/chat)