Source: https://ailoot.ai/docs/vi/cabinet/usage/
Canonical: https://ailoot.ai/docs/vi/cabinet/usage/
Language: vi

[API bảng điều khiển](https://ailoot.ai/docs/vi/) 

# Lịch sử và chi phí

[Markdown](https://ailoot.ai/docs/vi/cabinet/usage/index.md)

Phương thức, trường yêu cầu và phản hồi.

Phần này có 11 phương thức. Mở phương thức để xem điều kiện truy cập, trường yêu cầu và phản hồi.

| Phương thức và đường dẫn | Mô tả | Quyền truy cập |
| --- | --- | --- |
| `GET /api/v1/usage` | Lịch sử yêu cầu | Token trang quản lý tài khoản |
| `GET /api/v1/usage/:id` | Một yêu cầu trong lịch sử | Token trang quản lý tài khoản |
| `POST /api/v1/usage/dashboard/api-keys-usage` | Thống kê các khóa API của bạn | Token trang quản lý tài khoản |
| `GET /api/v1/usage/dashboard/models` | Mức sử dụng theo mô hình | Token trang quản lý tài khoản |
| `GET /api/v1/usage/dashboard/snapshot-v2` | Bản chụp tổng hợp dữ liệu biểu đồ | Token trang quản lý tài khoản |
| `GET /api/v1/usage/dashboard/stats` | Tổng hợp mức sử dụng | Token trang quản lý tài khoản |
| `GET /api/v1/usage/dashboard/trend` | Diễn biến mức sử dụng | Token trang quản lý tài khoản |
| `GET /api/v1/usage/errors` | Lịch sử lỗi | Token trang quản lý tài khoản |
| `GET /api/v1/usage/errors/:id` | Chi tiết lỗi của bạn | Token trang quản lý tài khoản |
| `GET /api/v1/usage/stats` | Thống kê mức sử dụng | Token trang quản lý tài khoản |
| `GET /api/v1/user/api-keys/:id/usage/daily` | Thống kê hằng ngày của khóa API của bạn | Token trang quản lý tài khoản |

**GET /api/v1/usage** — Lịch sử yêu cầu

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `sort_by` | `string` | không | ; mặc định: created\_at |
| `sort_order` | `string` | không | ; mặc định: desc |
| `api_key_id` | `integer` | không |  |
| `request_type` | `string` | không |  |
| `stream` | `boolean` | không |  |
| `timezone` | `string` | không |  |
| `start_date` | `string` | không |  |
| `end_date` | `string` | không |  |
| `period` | `string` | không |  |
| `model` | `string` | không |  |
| `page` | `integer` | không | ; mặc định: 1; positive; page\_size/limit \<=1000 |
| `page_size` | `integer` | không | ; mặc định: 20; positive; page\_size/limit \<=1000 |
| `limit` | `integer` | không | ; mặc định: 20; positive; page\_size/limit \<=1000 |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `UsageLog`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": "PLACEHOLDER_ID (integer)",
        "user_id": "PLACEHOLDER_USER_ID (integer)",
        "api_key_id": "PLACEHOLDER_API_KEY_ID (integer)",
        "request_id": "PLACEHOLDER_REQUEST_ID (string)",
        "model": "PLACEHOLDER_MODEL (string)",
        "service_tier": "PLACEHOLDER_SERVICE_TIER (string)",
        "reasoning_effort": "PLACEHOLDER_REASONING_EFFORT (string)",
        "input_tokens": "PLACEHOLDER_INPUT_TOKENS (integer)",
        "output_tokens": "PLACEHOLDER_OUTPUT_TOKENS (integer)",
        "cache_creation_tokens": "PLACEHOLDER_CACHE_CREATION_TOKENS (integer)",
        "cache_read_tokens": "PLACEHOLDER_CACHE_READ_TOKENS (integer)",
        "cache_creation_5m_tokens": "PLACEHOLDER_CACHE_CREATION_5M_TOKENS (integer)",
        "cache_creation_1h_tokens": "PLACEHOLDER_CACHE_CREATION_1H_TOKENS (integer)",
        "input_cost": "PLACEHOLDER_INPUT_COST (number)",
        "output_cost": "PLACEHOLDER_OUTPUT_COST (number)",
        "cache_creation_cost": "PLACEHOLDER_CACHE_CREATION_COST (number)",
        "cache_read_cost": "PLACEHOLDER_CACHE_READ_COST (number)",
        "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
        "actual_cost": "PLACEHOLDER_ACTUAL_COST (number)",
        "long_context_billing_applied": "PLACEHOLDER_LONG_CONTEXT_BILLING_APPLIED (boolean)",
        "request_type": "PLACEHOLDER_REQUEST_TYPE (string)",
        "stream": "PLACEHOLDER_STREAM (boolean)",
        "duration_ms": "PLACEHOLDER_DURATION_MS (integer)",
        "first_token_ms": "PLACEHOLDER_FIRST_TOKEN_MS (integer)",
        "image_count": "PLACEHOLDER_IMAGE_COUNT (integer)",
        "image_size": "PLACEHOLDER_IMAGE_SIZE (string)",
        "image_input_size": "PLACEHOLDER_IMAGE_INPUT_SIZE (string)",
        "image_output_size": "PLACEHOLDER_IMAGE_OUTPUT_SIZE (string)",
        "image_input_tokens": "PLACEHOLDER_IMAGE_INPUT_TOKENS (integer)",
        "image_input_cost": "PLACEHOLDER_IMAGE_INPUT_COST (number)",
        "image_output_tokens": "PLACEHOLDER_IMAGE_OUTPUT_TOKENS (integer)",
        "image_output_cost": "PLACEHOLDER_IMAGE_OUTPUT_COST (number)",
        "image_size_breakdown": "PLACEHOLDER_IMAGE_SIZE_BREAKDOWN (object)",
        "media_type": "PLACEHOLDER_MEDIA_TYPE (string)",
        "ip_address": "PLACEHOLDER_IP_ADDRESS (string)",
        "session_id": "PLACEHOLDER_SESSION_ID (string)",
        "created_at": "PLACEHOLDER_CREATED_AT (string)",
        "user": "PLACEHOLDER_USER (object)",
        "api_key": "PLACEHOLDER_API_KEY (object)"
      }
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/:id** — Một yêu cầu trong lịch sử

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/:id`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/$ID" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số đường dẫn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `id` | `integer` | có |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `UsageLog`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "id": "PLACEHOLDER_ID (integer)",
    "user_id": "PLACEHOLDER_USER_ID (integer)",
    "api_key_id": "PLACEHOLDER_API_KEY_ID (integer)",
    "request_id": "PLACEHOLDER_REQUEST_ID (string)",
    "model": "PLACEHOLDER_MODEL (string)",
    "service_tier": "PLACEHOLDER_SERVICE_TIER (string)",
    "reasoning_effort": "PLACEHOLDER_REASONING_EFFORT (string)",
    "input_tokens": "PLACEHOLDER_INPUT_TOKENS (integer)",
    "output_tokens": "PLACEHOLDER_OUTPUT_TOKENS (integer)",
    "cache_creation_tokens": "PLACEHOLDER_CACHE_CREATION_TOKENS (integer)",
    "cache_read_tokens": "PLACEHOLDER_CACHE_READ_TOKENS (integer)",
    "cache_creation_5m_tokens": "PLACEHOLDER_CACHE_CREATION_5M_TOKENS (integer)",
    "cache_creation_1h_tokens": "PLACEHOLDER_CACHE_CREATION_1H_TOKENS (integer)",
    "input_cost": "PLACEHOLDER_INPUT_COST (number)",
    "output_cost": "PLACEHOLDER_OUTPUT_COST (number)",
    "cache_creation_cost": "PLACEHOLDER_CACHE_CREATION_COST (number)",
    "cache_read_cost": "PLACEHOLDER_CACHE_READ_COST (number)",
    "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
    "actual_cost": "PLACEHOLDER_ACTUAL_COST (number)",
    "long_context_billing_applied": "PLACEHOLDER_LONG_CONTEXT_BILLING_APPLIED (boolean)",
    "request_type": "PLACEHOLDER_REQUEST_TYPE (string)",
    "stream": "PLACEHOLDER_STREAM (boolean)",
    "duration_ms": "PLACEHOLDER_DURATION_MS (integer)",
    "first_token_ms": "PLACEHOLDER_FIRST_TOKEN_MS (integer)",
    "image_count": "PLACEHOLDER_IMAGE_COUNT (integer)",
    "image_size": "PLACEHOLDER_IMAGE_SIZE (string)",
    "image_input_size": "PLACEHOLDER_IMAGE_INPUT_SIZE (string)",
    "image_output_size": "PLACEHOLDER_IMAGE_OUTPUT_SIZE (string)",
    "image_input_tokens": "PLACEHOLDER_IMAGE_INPUT_TOKENS (integer)",
    "image_input_cost": "PLACEHOLDER_IMAGE_INPUT_COST (number)",
    "image_output_tokens": "PLACEHOLDER_IMAGE_OUTPUT_TOKENS (integer)",
    "image_output_cost": "PLACEHOLDER_IMAGE_OUTPUT_COST (number)",
    "image_size_breakdown": "PLACEHOLDER_IMAGE_SIZE_BREAKDOWN (object)",
    "media_type": "PLACEHOLDER_MEDIA_TYPE (string)",
    "ip_address": "PLACEHOLDER_IP_ADDRESS (string)",
    "session_id": "PLACEHOLDER_SESSION_ID (string)",
    "created_at": "PLACEHOLDER_CREATED_AT (string)",
    "user": "PLACEHOLDER_USER (object)",
    "api_key": "PLACEHOLDER_API_KEY (object)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**POST /api/v1/usage/dashboard/api-keys-usage** — Thống kê các khóa API của bạn

Quyền truy cập: Token trang quản lý tài khoản

POST`/api/v1/usage/dashboard/api-keys-usage`

## Các trường JSON / biểu mẫu

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `api_key_ids` | `array` | có | required |

Mẫu nội dung yêu cầu

```json
{
  "api_key_ids": "PLACEHOLDER_API_KEY_IDS (array)"
}
```

PLACEHOLDER biểu thị dữ liệu bạn nhập và kiểu dữ liệu đó. Thay các giá trị và chỉ giữ những trường tùy chọn cần thiết; không gửi chuỗi đánh dấu thay cho số, boolean, đối tượng hoặc mảng.

Lược đồ yêu cầu: `BatchAPIKeysUsageRequest`

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `BatchAPIKeyUsageStats`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "api_key_id": "PLACEHOLDER_API_KEY_ID (integer)",
    "today_actual_cost": "PLACEHOLDER_TODAY_ACTUAL_COST (number)",
    "total_actual_cost": "PLACEHOLDER_TOTAL_ACTUAL_COST (number)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

Đặc điểm: Phương thức đọc thống kê các khóa API của chính bạn; ví dụ mô tả hợp đồng API và không được thực thi.

Phương thức trả về thống kê và không thay đổi khóa API hay chi phí. Đọc lại không cần Idempotency-Key; phản hồi thể hiện trạng thái tại thời điểm yêu cầu.

**GET /api/v1/usage/dashboard/models** — Mức sử dụng theo mô hình

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/dashboard/models`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/models" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `api_key_id` | `integer` | không |  |
| `request_type` | `string` | không |  |
| `stream` | `boolean` | không |  |
| `timezone` | `string` | không |  |
| `start_date` | `string` | không |  |
| `end_date` | `string` | không |  |
| `period` | `string` | không |  |
| `model` | `string` | không |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "end_date": "VALUE_FROM_RESPONSE",
    "models": "VALUE_FROM_RESPONSE",
    "month": "VALUE_FROM_RESPONSE",
    "start_date": "VALUE_FROM_RESPONSE",
    "today": "VALUE_FROM_RESPONSE",
    "week": "VALUE_FROM_RESPONSE"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/dashboard/snapshot-v2** — Bản chụp tổng hợp dữ liệu biểu đồ

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/dashboard/snapshot-v2`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/snapshot-v2" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `granularity` | `string` | không | ; mặc định: day |
| `include_trend` | `boolean` | không | ; mặc định: true |
| `include_model_stats` | `boolean` | không | ; mặc định: true |
| `api_key_id` | `integer` | không |  |
| `request_type` | `string` | không |  |
| `stream` | `boolean` | không |  |
| `timezone` | `string` | không |  |
| `start_date` | `string` | không |  |
| `end_date` | `string` | không |  |
| `period` | `string` | không |  |
| `model` | `string` | không |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "end_date": "VALUE_FROM_RESPONSE",
    "generated_at": "VALUE_FROM_RESPONSE",
    "granularity": "VALUE_FROM_RESPONSE",
    "month": "VALUE_FROM_RESPONSE",
    "start_date": "VALUE_FROM_RESPONSE",
    "today": "VALUE_FROM_RESPONSE",
    "week": "VALUE_FROM_RESPONSE"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/dashboard/stats** — Tổng hợp mức sử dụng

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/dashboard/stats`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/stats" \
  -H "Authorization: Bearer $TOKEN"
```

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `UserDashboardStats`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "total_api_keys": "PLACEHOLDER_TOTAL_API_KEYS (integer)",
    "active_api_keys": "PLACEHOLDER_ACTIVE_API_KEYS (integer)",
    "total_requests": "PLACEHOLDER_TOTAL_REQUESTS (integer)",
    "total_input_tokens": "PLACEHOLDER_TOTAL_INPUT_TOKENS (integer)",
    "total_output_tokens": "PLACEHOLDER_TOTAL_OUTPUT_TOKENS (integer)",
    "total_cache_creation_tokens": "PLACEHOLDER_TOTAL_CACHE_CREATION_TOKENS (integer)",
    "total_cache_read_tokens": "PLACEHOLDER_TOTAL_CACHE_READ_TOKENS (integer)",
    "total_tokens": "PLACEHOLDER_TOTAL_TOKENS (integer)",
    "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
    "total_actual_cost": "PLACEHOLDER_TOTAL_ACTUAL_COST (number)",
    "today_requests": "PLACEHOLDER_TODAY_REQUESTS (integer)",
    "today_input_tokens": "PLACEHOLDER_TODAY_INPUT_TOKENS (integer)",
    "today_output_tokens": "PLACEHOLDER_TODAY_OUTPUT_TOKENS (integer)",
    "today_cache_creation_tokens": "PLACEHOLDER_TODAY_CACHE_CREATION_TOKENS (integer)",
    "today_cache_read_tokens": "PLACEHOLDER_TODAY_CACHE_READ_TOKENS (integer)",
    "today_tokens": "PLACEHOLDER_TODAY_TOKENS (integer)",
    "today_cost": "PLACEHOLDER_TODAY_COST (number)",
    "today_actual_cost": "PLACEHOLDER_TODAY_ACTUAL_COST (number)",
    "average_duration_ms": "PLACEHOLDER_AVERAGE_DURATION_MS (number)",
    "rpm": "PLACEHOLDER_RPM (integer)",
    "tpm": "PLACEHOLDER_TPM (integer)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/dashboard/trend** — Diễn biến mức sử dụng

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/dashboard/trend`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/trend" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `granularity` | `string` | không | ; mặc định: day |
| `api_key_id` | `integer` | không |  |
| `request_type` | `string` | không |  |
| `stream` | `boolean` | không |  |
| `timezone` | `string` | không |  |
| `start_date` | `string` | không |  |
| `end_date` | `string` | không |  |
| `period` | `string` | không |  |
| `model` | `string` | không |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "end_date": "VALUE_FROM_RESPONSE",
    "granularity": "VALUE_FROM_RESPONSE",
    "month": "VALUE_FROM_RESPONSE",
    "start_date": "VALUE_FROM_RESPONSE",
    "today": "VALUE_FROM_RESPONSE",
    "trend": "VALUE_FROM_RESPONSE",
    "week": "VALUE_FROM_RESPONSE"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/errors** — Lịch sử lỗi

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/errors`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/errors" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `timezone` | `string` | không |  |
| `start_date` | `string` | không |  |
| `end_date` | `string` | không |  |
| `model` | `string` | không |  |
| `api_key_id` | `integer` | không |  |
| `status_code` | `integer` | không |  |
| `category` | `string` | không |  |
| `sort_by` | `string` | không |  |
| `sort_order` | `string` | không |  |
| `page` | `integer` | không | ; mặc định: 1; positive; page\_size/limit \<=1000 |
| `page_size` | `integer` | không | ; mặc định: 20; positive; page\_size/limit \<=1000 |
| `limit` | `integer` | không | ; mặc định: 20; positive; page\_size/limit \<=1000 |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      "PLACEHOLDER_DATA (object, mô tả nằm trên trang «Lược đồ dữ liệu»)"
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/errors/:id** — Chi tiết lỗi của bạn

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/errors/:id`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/errors/$ID" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số đường dẫn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `id` | `integer` | có |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": "PLACEHOLDER_DATA (object, mô tả nằm trên trang «Lược đồ dữ liệu»)"
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/usage/stats** — Thống kê mức sử dụng

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/usage/stats`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/usage/stats" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `api_key_id` | `integer` | không |  |
| `request_type` | `string` | không |  |
| `stream` | `boolean` | không |  |
| `timezone` | `string` | không |  |
| `start_date` | `string` | không |  |
| `end_date` | `string` | không |  |
| `period` | `string` | không |  |
| `model` | `string` | không |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `UsageStats`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "total_requests": "PLACEHOLDER_TOTAL_REQUESTS (integer)",
    "total_input_tokens": "PLACEHOLDER_TOTAL_INPUT_TOKENS (integer)",
    "total_output_tokens": "PLACEHOLDER_TOTAL_OUTPUT_TOKENS (integer)",
    "total_cache_tokens": "PLACEHOLDER_TOTAL_CACHE_TOKENS (integer)",
    "total_cache_creation_tokens": "PLACEHOLDER_TOTAL_CACHE_CREATION_TOKENS (integer)",
    "total_cache_read_tokens": "PLACEHOLDER_TOTAL_CACHE_READ_TOKENS (integer)",
    "total_tokens": "PLACEHOLDER_TOTAL_TOKENS (integer)",
    "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
    "total_actual_cost": "PLACEHOLDER_TOTAL_ACTUAL_COST (number)",
    "average_duration_ms": "PLACEHOLDER_AVERAGE_DURATION_MS (number)",
    "endpoints": "PLACEHOLDER_ENDPOINTS (array)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

**GET /api/v1/user/api-keys/:id/usage/daily** — Thống kê hằng ngày của khóa API của bạn

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/user/api-keys/:id/usage/daily`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/user/api-keys/$ID/usage/daily" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số đường dẫn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `id` | `integer` | có |  |

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `days` | `integer` | không | ; mặc định: 30 |
| `timezone` | `string` | không |  |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `APIKeyDailyUsagePoint`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "date": "PLACEHOLDER_DATE (string)",
    "requests": "PLACEHOLDER_REQUESTS (integer)",
    "input_tokens": "PLACEHOLDER_INPUT_TOKENS (integer)",
    "output_tokens": "PLACEHOLDER_OUTPUT_TOKENS (integer)",
    "cache_read_tokens": "PLACEHOLDER_CACHE_READ_TOKENS (integer)",
    "cache_write_tokens": "PLACEHOLDER_CACHE_WRITE_TOKENS (integer)",
    "total_tokens": "PLACEHOLDER_TOTAL_TOKENS (integer)",
    "cost": "PLACEHOLDER_COST (number)",
    "actual_cost": "PLACEHOLDER_ACTUAL_COST (number)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

## Lịch sử và chi phí · USD

total\_cost là chi phí tính theo biểu giá; actual\_cost là khoản phí đã ghi nhận bằng USD.

### Ví dụ tính toán

```json
{
  "total_cost": 0.1,
  "actual_cost": 0.08
}
```

`period ∈ {today, week, month}`; `start_date, end_date: YYYY-MM-DD`; `timezone: IANA` · `timezone=UTC`. `end_date`: `[00:00, +1 day 00:00)`. `display: actual_cost.toFixed(8)`; `JSON: number`.

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.