> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dgrid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 요청 결제 세부 정보 조회

> 완료된 Model API 요청의 토큰 사용량, 가격 스냅샷, USD 비용 세부 정보를 조회합니다.

단일 Model API 요청의 결제 기록을 조회합니다. 사용자별 사용량을 대조하거나, 모델 비용을 감사하거나, 요청이 청구될 때 적용된 가격 스냅샷을 확인해야 할 때 이 엔드포인트를 사용하세요.

<Note>
  원래 모델 요청을 보낸 것과 동일한 DGrid API 키를 사용해야 합니다. 결제 기록은 인증된 키에 연결되며, 다른 키의 기록은 조회할 수 없습니다.
</Note>

## 엔드포인트

```http theme={null}
GET https://api.dgrid.ai/api/v1/model-router/billing-json?request_id=<DGRID_REQUEST_ID>
```

|                     |                                         |
| ------------------- | --------------------------------------- |
| <strong>인증</strong> | `Authorization: Bearer <DGRID_API_KEY>` |
| <strong>요청</strong> | 쿼리 파라미터                                 |
| <strong>응답</strong> | `application/json`                      |

## 쿼리 파라미터

| 파라미터         | 유형     | 필수 | 설명                                    |
| ------------ | ------ | -- | ------------------------------------- |
| `request_id` | string | 예  | 결제 세부 정보를 조회할 완료된 Model API 요청 ID입니다. |

## 요청 ID 가져오기

DGrid는 원래 모델 호출의 `DGrid-Request-ID` 응답 헤더에 요청 ID를 반환합니다. 나중에 결제 세부 정보를 조회하거나 대조해야 한다면 이 값을 저장하세요.

```http theme={null}
DGrid-Request-ID: req_178027***********6dc9x
```

## 요청 예시

<RequestExample>
  ```bash cURL theme={null}
  curl --location \
    'https://api.dgrid.ai/api/v1/model-router/billing-json?request_id=<DGRID_REQUEST_ID>' \
    --header 'Authorization: Bearer <DGRID_API_KEY>'
  ```
</RequestExample>

## 응답

### 200 OK

결제 기록을 찾았으며, 해당 기록이 인증된 API 키에 속합니다.

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 200,
    "message": "ok",
    "data": {
      "request_id": "req_**********86dc9x",
      "billing_json": {
        "model": "anthropic/claude-opus-4.6",
        "input_cost": 0.54909,
        "output_cost": 0.0027500000000000003,
        "cache_create_cost": 0,
        "cache_read_cost": 0,
        "request_cost": 0,
        "total_cost": 0.55184,
        "supplier_id": 1,
        "input_tokens": 109818,
        "output_tokens": 110,
        "cache_create_tokens": 0,
        "cache_read_tokens": 0,
        "pricing_mode": "usage",
        "pricing_snapshot": {
          "pricing_mode": "usage",
          "input_price_per_1m": 5,
          "output_price_per_1m": 25,
          "cache_create_price": 6.25,
          "cache_read_price": 0.5,
          "price_per_request": null,
          "input_tiers": [],
          "output_tiers": [],
          "cache_create_tiers": [],
          "cache_read_tiers": []
        }
      }
    }
  }
  ```

  ```json 401 theme={null}
  {
    "code": 401,
    "message": "unauthorized"
  }
  ```

  ```json 404 theme={null}
  {
    "code": 404,
    "message": "not found"
  }
  ```
</ResponseExample>

## 결제 필드

| 필드                                          | 설명                                                 |
| ------------------------------------------- | -------------------------------------------------- |
| `model`                                     | 원래 요청에서 사용한 모델 ID입니다.                              |
| `input_tokens` / `output_tokens`            | 프롬프트와 생성된 출력에 대해 청구된 토큰 수입니다.                      |
| `cache_create_tokens` / `cache_read_tokens` | 캐시 가격이 적용될 때의 캐시 관련 토큰 수입니다.                       |
| `input_cost` / `output_cost`                | 입력 및 출력 토큰 사용량에 해당하는 USD 비용입니다.                    |
| `cache_create_cost` / `cache_read_cost`     | 캐시 생성 및 캐시 읽기에 해당하는 USD 비용입니다.                     |
| `request_cost`                              | 가격 모드에 고정 요청 비용이 포함된 경우의 USD 비용입니다.                |
| `total_cost`                                | 해당 요청에 최종 청구된 USD 비용입니다.                           |
| `pricing_snapshot`                          | 청구 시점에 사용된 가격 설정입니다. 이후 가격 변경은 이 과거 기록을 수정하지 않습니다. |

## 모범 사례

* 이후 사용량 대조를 위해 `DGrid-Request-ID`를 자체 요청 로그와 함께 저장하세요.
* `pricing_snapshot`은 해당 요청의 변경되지 않는 과거 가격 기록으로 취급하세요.
* 모든 비용과 가격 필드는 USD 기준입니다.
* 숫자 값은 소수 자릿수가 달라질 수 있으므로, 고정된 소수 형식에 의존하지 마세요.