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

[API πίνακα ελέγχου](https://ailoot.ai/docs/el/) 

# Ιστορικό και δαπάνες

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

Μέθοδοι, πεδία αιτημάτων και απαντήσεις.

Η ενότητα περιλαμβάνει 11 μεθόδους. Ανοίξτε τη μέθοδο για να δείτε τους όρους πρόσβασης, τα πεδία αιτήματος και την απάντηση.

| Μέθοδος και διαδρομή | Περιγραφή | Πρόσβαση |
| --- | --- | --- |
| `GET /api/v1/usage` | Ιστορικό αιτημάτων | Token πίνακα ελέγχου |
| `GET /api/v1/usage/:id` | Ένα αίτημα από το ιστορικό | Token πίνακα ελέγχου |
| `POST /api/v1/usage/dashboard/api-keys-usage` | Στατιστικά των δικών σας κλειδιών API | Token πίνακα ελέγχου |
| `GET /api/v1/usage/dashboard/models` | Χρήση ανά μοντέλο | Token πίνακα ελέγχου |
| `GET /api/v1/usage/dashboard/snapshot-v2` | Ενιαίο στιγμιότυπο γραφημάτων | Token πίνακα ελέγχου |
| `GET /api/v1/usage/dashboard/stats` | Σύνοψη χρήσης | Token πίνακα ελέγχου |
| `GET /api/v1/usage/dashboard/trend` | Εξέλιξη χρήσης | Token πίνακα ελέγχου |
| `GET /api/v1/usage/errors` | Ιστορικό σφαλμάτων | Token πίνακα ελέγχου |
| `GET /api/v1/usage/errors/:id` | Λεπτομέρειες δικού σας σφάλματος | Token πίνακα ελέγχου |
| `GET /api/v1/usage/stats` | Στατιστικά χρήσης | Token πίνακα ελέγχου |
| `GET /api/v1/user/api-keys/:id/usage/daily` | Ημερήσια στατιστικά δικού σας κλειδιού API | Token πίνακα ελέγχου |

**GET /api/v1/usage** — Ιστορικό αιτημάτων

Πρόσβαση: Token πίνακα ελέγχου

GET`/api/v1/usage`

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `sort_by` | `string` | όχι | ; από προεπιλογή: created\_at |
| `sort_order` | `string` | όχι | ; από προεπιλογή: desc |
| `api_key_id` | `integer` | όχι |  |
| `request_type` | `string` | όχι |  |
| `stream` | `boolean` | όχι |  |
| `timezone` | `string` | όχι |  |
| `start_date` | `string` | όχι |  |
| `end_date` | `string` | όχι |  |
| `period` | `string` | όχι |  |
| `model` | `string` | όχι |  |
| `page` | `integer` | όχι | ; από προεπιλογή: 1; θετικό; page\_size/limit \<=1000 |
| `page_size` | `integer` | όχι | ; από προεπιλογή: 20; θετικό; page\_size/limit \<=1000 |
| `limit` | `integer` | όχι | ; από προεπιλογή: 20; θετικό; page\_size/limit \<=1000 |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `UsageLog`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

```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)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/:id** — Ένα αίτημα από το ιστορικό

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι διαδρομής

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `id` | `integer` | ναι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `UsageLog`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

```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)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**POST /api/v1/usage/dashboard/api-keys-usage** — Στατιστικά των δικών σας κλειδιών API

Πρόσβαση: Token πίνακα ελέγχου

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

## Πεδία JSON / φόρμας

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `api_key_ids` | `array` | ναι | required |

Πρότυπο σώματος αιτήματος

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

Το PLACEHOLDER υποδηλώνει τη δική σας είσοδο και τον τύπο της. Αντικαταστήστε τις τιμές και κρατήστε μόνο τα προαιρετικά πεδία που χρειάζονται· οι συμβολοσειρές-δείκτες δεν αποστέλλονται αντί για αριθμούς, boolean, αντικείμενα ή πίνακες.

Σχήμα αιτήματος: `BatchAPIKeysUsageRequest`

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `BatchAPIKeyUsageStats`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

```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)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

Ιδιαιτερότητες: Η μέθοδος διαβάζει τα στατιστικά των δικών σας κλειδιών API· το παράδειγμα περιγράφει τη σύμβαση λειτουργίας και δεν εκτελείται.

Η μέθοδος επιστρέφει στατιστικά και δεν τροποποιεί τα κλειδιά API ή τις δαπάνες. Για να διαβάσετε ξανά τα δεδομένα, δεν απαιτείται Idempotency-Key· η απάντηση αποτυπώνει την κατάσταση κατά τη στιγμή του αιτήματος.

**GET /api/v1/usage/dashboard/models** — Χρήση ανά μοντέλο

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `api_key_id` | `integer` | όχι |  |
| `request_type` | `string` | όχι |  |
| `stream` | `boolean` | όχι |  |
| `timezone` | `string` | όχι |  |
| `start_date` | `string` | όχι |  |
| `end_date` | `string` | όχι |  |
| `period` | `string` | όχι |  |
| `model` | `string` | όχι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήμα απάντησης, ενδεικτικές τιμές

```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"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/dashboard/snapshot-v2** — Ενιαίο στιγμιότυπο γραφημάτων

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `granularity` | `string` | όχι | ; από προεπιλογή: day |
| `include_trend` | `boolean` | όχι | ; από προεπιλογή: true |
| `include_model_stats` | `boolean` | όχι | ; από προεπιλογή: true |
| `api_key_id` | `integer` | όχι |  |
| `request_type` | `string` | όχι |  |
| `stream` | `boolean` | όχι |  |
| `timezone` | `string` | όχι |  |
| `start_date` | `string` | όχι |  |
| `end_date` | `string` | όχι |  |
| `period` | `string` | όχι |  |
| `model` | `string` | όχι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήμα απάντησης, ενδεικτικές τιμές

```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"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/dashboard/stats** — Σύνοψη χρήσης

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `UserDashboardStats`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

```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)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/dashboard/trend** — Εξέλιξη χρήσης

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `granularity` | `string` | όχι | ; από προεπιλογή: day |
| `api_key_id` | `integer` | όχι |  |
| `request_type` | `string` | όχι |  |
| `stream` | `boolean` | όχι |  |
| `timezone` | `string` | όχι |  |
| `start_date` | `string` | όχι |  |
| `end_date` | `string` | όχι |  |
| `period` | `string` | όχι |  |
| `model` | `string` | όχι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήμα απάντησης, ενδεικτικές τιμές

```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"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/errors** — Ιστορικό σφαλμάτων

Πρόσβαση: Token πίνακα ελέγχου

GET`/api/v1/usage/errors`

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `timezone` | `string` | όχι |  |
| `start_date` | `string` | όχι |  |
| `end_date` | `string` | όχι |  |
| `model` | `string` | όχι |  |
| `api_key_id` | `integer` | όχι |  |
| `status_code` | `integer` | όχι |  |
| `category` | `string` | όχι |  |
| `sort_by` | `string` | όχι |  |
| `sort_order` | `string` | όχι |  |
| `page` | `integer` | όχι | ; από προεπιλογή: 1; θετικό; page\_size/limit \<=1000 |
| `page_size` | `integer` | όχι | ; από προεπιλογή: 20; θετικό; page\_size/limit \<=1000 |
| `limit` | `integer` | όχι | ; από προεπιλογή: 20; θετικό; page\_size/limit \<=1000 |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήμα απάντησης, ενδεικτικές τιμές

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      "PLACEHOLDER_DATA (object, περιγραφή — στη σελίδα «Σχήματα δεδομένων»)"
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/errors/:id** — Λεπτομέρειες δικού σας σφάλματος

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι διαδρομής

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `id` | `integer` | ναι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήμα απάντησης, ενδεικτικές τιμές

```json
{
  "code": 0,
  "message": "success",
  "data": "PLACEHOLDER_DATA (object, περιγραφή — στη σελίδα «Σχήματα δεδομένων»)"
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/usage/stats** — Στατιστικά χρήσης

Πρόσβαση: Token πίνακα ελέγχου

GET`/api/v1/usage/stats`

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `api_key_id` | `integer` | όχι |  |
| `request_type` | `string` | όχι |  |
| `stream` | `boolean` | όχι |  |
| `timezone` | `string` | όχι |  |
| `start_date` | `string` | όχι |  |
| `end_date` | `string` | όχι |  |
| `period` | `string` | όχι |  |
| `model` | `string` | όχι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `UsageStats`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

```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)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

**GET /api/v1/user/api-keys/:id/usage/daily** — Ημερήσια στατιστικά δικού σας κλειδιού API

Πρόσβαση: Token πίνακα ελέγχου

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

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι διαδρομής

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `id` | `integer` | ναι |  |

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `days` | `integer` | όχι | ; από προεπιλογή: 30 |
| `timezone` | `string` | όχι |  |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `APIKeyDailyUsagePoint`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

```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)"
  }
}
```

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

## Ιστορικό και δαπάνες · USD

total\_cost είναι το υπολογισμένο κόστος τιμολογίου· actual\_cost είναι η καταγεγραμμένη χρέωση σε USD.

### Παράδειγμα υπολογισμού

```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`.

Έχετε ερωτήσεις; Στείλτε μας το Request ID και μια περιγραφή — θα σας βοηθήσουμε να βρείτε την αιτία.[Επικοινωνία με την υποστήριξη](mailto:support@ailoot.ai)

## Ailoot · Η εταιρεία και το χαρτοφυλάκιο έργων της





Η Ailoot στηρίζεται στη συσσωρευμένη λειτουργική εμπειρία, τη μεγάλη πελατειακή βάση, τη σταθερή εξυπηρέτηση και τον συνεχή έλεγχο KPI.





Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.





Η Ailoot αξιοποιεί αυτή τη λειτουργική εμπειρία για πρόσβαση μέσω API σε λειτουργίες AI στα προϊόντα, τους πράκτορες, τις εφαρμογές και τους αυτοματισμούς των πελατών.