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

# 计费摘要

> 返回钱包余额、累计总支出，以及最近 30 天的 GPU 与令牌用量。

查看你当前的钱包余额、累计已结算支出，以及最近 30 天的聚合用量。以空用户作用域调用此接口的管理员用户会收到跨所有用户的聚合视图。

## 接口

**GET** `/v1/billing/summary`

认证：`Authorization: Bearer $ARIA_PIN_KEY`

## 响应

<ResponseField name="user_id" type="string">
  用户 ID；管理员聚合视图时为空。
</ResponseField>

<ResponseField name="balance" type="number">
  当前钱包余额，以所配置币种计。
</ResponseField>

<ResponseField name="currency" type="string">
  计费币种（例如 `USD`）。
</ResponseField>

<ResponseField name="total_spent" type="number">
  跨所有计费记录的累计已结算支出。
</ResponseField>

<ResponseField name="usage_30d" type="object">
  最近 30 天的 GPU 与令牌用量。

  <Expandable>
    <ResponseField name="gpu_seconds" type="number">
      消耗的总 GPU 秒数。
    </ResponseField>

    <ResponseField name="tokens" type="integer">
      处理的总令牌数。
    </ResponseField>
  </Expandable>
</ResponseField>

## 示例

```bash theme={null}
curl http://<pin-host>:8001/v1/billing/summary \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "user_id": "usr_abc",
  "balance": 124.5,
  "currency": "USD",
  "total_spent": 75.5,
  "usage_30d": {
    "gpu_seconds": 3600.0,
    "tokens": 5000000
  }
}
```