Tarix va sarf

Metodlar, so‘rov maydonlari va javoblar.

To‘liq qo‘llanma

Bo‘limda 11 ta metod bor. Kirish shartlari, so‘rov maydonlari va javobni ko‘rish uchun metodni oching.

Metod va yo‘l	Tavsif	Kirish huquqi
`GET /api/v1/usage`	So‘rovlar tarixi	Boshqaruv paneli tokeni
`GET /api/v1/usage/:id`	Tarixdagi bitta so‘rov	Boshqaruv paneli tokeni
`POST /api/v1/usage/dashboard/api-keys-usage`	O‘z API kalitlaringiz statistikasi	Boshqaruv paneli tokeni
`GET /api/v1/usage/dashboard/models`	Modellar bo‘yicha foydalanish	Boshqaruv paneli tokeni
`GET /api/v1/usage/dashboard/snapshot-v2`	Grafiklarning yagona holat nusxasi	Boshqaruv paneli tokeni
`GET /api/v1/usage/dashboard/stats`	Foydalanish yakunlari	Boshqaruv paneli tokeni
`GET /api/v1/usage/dashboard/trend`	Foydalanish dinamikasi	Boshqaruv paneli tokeni
`GET /api/v1/usage/errors`	Xatolar tarixi	Boshqaruv paneli tokeni
`GET /api/v1/usage/errors/:id`	O‘z xatongiz tafsilotlari	Boshqaruv paneli tokeni
`GET /api/v1/usage/stats`	Foydalanish statistikasi	Boshqaruv paneli tokeni
`GET /api/v1/user/api-keys/:id/usage/daily`	O‘z API kalitingizning kunlik statistikasi	Boshqaruv paneli tokeni

GET /api/v1/usage — So‘rovlar tarixi

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage

O‘qish; ID oldingi javobingizdan olinadi

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

Query parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`sort_by`	`string`	yo‘q	; standart qiymat: created_at
`sort_order`	`string`	yo‘q	; standart qiymat: desc
`api_key_id`	`integer`	yo‘q
`request_type`	`string`	yo‘q
`stream`	`boolean`	yo‘q
`timezone`	`string`	yo‘q
`start_date`	`string`	yo‘q
`end_date`	`string`	yo‘q
`period`	`string`	yo‘q
`model`	`string`	yo‘q
`page`	`integer`	yo‘q	; standart qiymat: 1; positive; page_size/limit <=1000
`page_size`	`integer`	yo‘q	; standart qiymat: 20; positive; page_size/limit <=1000
`limit`	`integer`	yo‘q	; standart qiymat: 20; positive; page_size/limit <=1000

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: UsageLog. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/:id — Tarixdagi bitta so‘rov

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage/:id

O‘qish; ID oldingi javobingizdan olinadi

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

Yo‘l parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`id`	`integer`	ha

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: UsageLog. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

POST /api/v1/usage/dashboard/api-keys-usage — O‘z API kalitlaringiz statistikasi

Kirish: Boshqaruv paneli tokeni

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

JSON / forma maydonlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`api_key_ids`	`array`	ha	required

So‘rov tanasi shabloni

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

PLACEHOLDER siz kiritadigan qiymat va uning turini bildiradi. Qiymatlarni almashtiring va faqat kerakli ixtiyoriy maydonlarni qoldiring; sonlar, boolean, obyektlar yoki massivlar o‘rniga matnli belgilar yuborilmaydi.

So‘rov sxemasi: BatchAPIKeysUsageRequest

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: BatchAPIKeyUsageStats. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

Xususiyatlar: Metod o‘z API kalitlaringiz statistikasini o‘qiydi; misol API shartnomasini tavsiflaydi va bajarilmaydi.

GET /api/v1/usage/dashboard/models — Modellar bo‘yicha foydalanish

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage/dashboard/models

O‘qish; ID oldingi javobingizdan olinadi

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

Query parametrlari

Maydon:	Tur	Majburiy
`api_key_id`	`integer`	yo‘q
`request_type`	`string`	yo‘q
`stream`	`boolean`	yo‘q
`timezone`	`string`	yo‘q
`start_date`	`string`	yo‘q
`end_date`	`string`	yo‘q
`period`	`string`	yo‘q
`model`	`string`	yo‘q

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/dashboard/snapshot-v2 — Grafiklarning yagona holat nusxasi

Kirish: Boshqaruv paneli tokeni

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

O‘qish; ID oldingi javobingizdan olinadi

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

Query parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`granularity`	`string`	yo‘q	; standart qiymat: day
`include_trend`	`boolean`	yo‘q	; standart qiymat: true
`include_model_stats`	`boolean`	yo‘q	; standart qiymat: true
`api_key_id`	`integer`	yo‘q
`request_type`	`string`	yo‘q
`stream`	`boolean`	yo‘q
`timezone`	`string`	yo‘q
`start_date`	`string`	yo‘q
`end_date`	`string`	yo‘q
`period`	`string`	yo‘q
`model`	`string`	yo‘q

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/dashboard/stats — Foydalanish yakunlari

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage/dashboard/stats

O‘qish; ID oldingi javobingizdan olinadi

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

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: UserDashboardStats. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/dashboard/trend — Foydalanish dinamikasi

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage/dashboard/trend

O‘qish; ID oldingi javobingizdan olinadi

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

Query parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`granularity`	`string`	yo‘q	; standart qiymat: day
`api_key_id`	`integer`	yo‘q
`request_type`	`string`	yo‘q
`stream`	`boolean`	yo‘q
`timezone`	`string`	yo‘q
`start_date`	`string`	yo‘q
`end_date`	`string`	yo‘q
`period`	`string`	yo‘q
`model`	`string`	yo‘q

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/errors — Xatolar tarixi

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage/errors

O‘qish; ID oldingi javobingizdan olinadi

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

Query parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`timezone`	`string`	yo‘q
`start_date`	`string`	yo‘q
`end_date`	`string`	yo‘q
`model`	`string`	yo‘q
`api_key_id`	`integer`	yo‘q
`status_code`	`integer`	yo‘q
`category`	`string`	yo‘q
`sort_by`	`string`	yo‘q
`sort_order`	`string`	yo‘q
`page`	`integer`	yo‘q	; standart qiymat: 1; positive; page_size/limit <=1000
`page_size`	`integer`	yo‘q	; standart qiymat: 20; positive; page_size/limit <=1000
`limit`	`integer`	yo‘q	; standart qiymat: 20; positive; page_size/limit <=1000

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob sxemasi, qiymatlar shartli

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      "PLACEHOLDER_DATA (object, tavsifi — «Ma’lumotlar sxemalari» sahifasida)"
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/errors/:id — O‘z xatongiz tafsilotlari

Kirish: Boshqaruv paneli tokeni

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

O‘qish; ID oldingi javobingizdan olinadi

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

Yo‘l parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`id`	`integer`	ha

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob sxemasi, qiymatlar shartli

{
  "code": 0,
  "message": "success",
  "data": "PLACEHOLDER_DATA (object, tavsifi — «Ma’lumotlar sxemalari» sahifasida)"
}

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/usage/stats — Foydalanish statistikasi

Kirish: Boshqaruv paneli tokeni

GET/api/v1/usage/stats

O‘qish; ID oldingi javobingizdan olinadi

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

Query parametrlari

Maydon:	Tur	Majburiy
`api_key_id`	`integer`	yo‘q
`request_type`	`string`	yo‘q
`stream`	`boolean`	yo‘q
`timezone`	`string`	yo‘q
`start_date`	`string`	yo‘q
`end_date`	`string`	yo‘q
`period`	`string`	yo‘q
`model`	`string`	yo‘q

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: UsageStats. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

GET /api/v1/user/api-keys/:id/usage/daily — O‘z API kalitingizning kunlik statistikasi

Kirish: Boshqaruv paneli tokeni

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

O‘qish; ID oldingi javobingizdan olinadi

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

Yo‘l parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`id`	`integer`	ha

Query parametrlari

Maydon:	Tur	Majburiy	Tekshiruv / tavsif
`days`	`integer`	yo‘q	; standart qiymat: 30
`timezone`	`string`	yo‘q

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: APIKeyDailyUsagePoint. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

Tarix va sarf · USD

total_cost — tarif bo‘yicha hisoblangan narx; actual_cost — USD da qayd etilgan hisobdan chiqarish summasi.

Hisoblash misoli

{
  "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.

Savollaringiz qoldimi? Request ID va tavsifni yuboring — tushunishga yordam beramiz.Yordam xizmatiga yozish