Тарих және шығындар

Әдістер, сұрау өрістері және жауаптар.

Толық нұсқаулық

Бөлімде 11 әдіс бар. Қол жеткізу шарттарын, сұрау өрістерін және жауапты көру үшін әдісті ашыңыз.

Әдіс және жол	Сипаттамасы	Қол жеткізу
`GET /api/v1/usage`	Сұраулар тарихы	Жеке кабинет токені
`GET /api/v1/usage/:id`	Тарихтағы бір сұрау	Жеке кабинет токені
`POST /api/v1/usage/dashboard/api-keys-usage`	Өз API кілттеріңіздің статистикасы	Жеке кабинет токені
`GET /api/v1/usage/dashboard/models`	Модельдер бойынша пайдалану	Жеке кабинет токені
`GET /api/v1/usage/dashboard/snapshot-v2`	Графиктердің бірыңғай сәттік көрінісі	Жеке кабинет токені
`GET /api/v1/usage/dashboard/stats`	Пайдалану қорытындылары	Жеке кабинет токені
`GET /api/v1/usage/dashboard/trend`	Пайдалану динамикасы	Жеке кабинет токені
`GET /api/v1/usage/errors`	Қателер тарихы	Жеке кабинет токені
`GET /api/v1/usage/errors/:id`	Өз қатеңіз туралы мәліметтер	Жеке кабинет токені
`GET /api/v1/usage/stats`	Пайдалану статистикасы	Жеке кабинет токені
`GET /api/v1/user/api-keys/:id/usage/daily`	Өз API кілтіңіздің күндік статистикасы	Жеке кабинет токені

GET /api/v1/usage — Сұраулар тарихы

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage

Оқу; ID алдыңғы жауабыңыздан алынады

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

Query параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`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; positive; page_size/limit <=1000
`page_size`	`integer`	жоқ	; әдепкіде: 20; positive; page_size/limit <=1000
`limit`	`integer`	жоқ	; әдепкіде: 20; positive; page_size/limit <=1000

Сұрау денесі қажет емес. Жоғарыда көрсетілген параметрлерді URL ішінде жіберіңіз.

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап деректерінің схемалары: UsageLog. Өрістер мен түрлер «Деректер схемалары» беттерінде берілген.

Жауап схемасы, мәндері шартты

{
  "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 — Тарихтағы бір сұрау

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage/:id

Оқу; ID алдыңғы жауабыңыздан алынады

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

Жол параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`id`	`integer`	иә

Сұрау денесі қажет емес. Жоғарыда көрсетілген параметрлерді URL ішінде жіберіңіз.

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап деректерінің схемалары: UsageLog. Өрістер мен түрлер «Деректер схемалары» беттерінде берілген.

Жауап схемасы, мәндері шартты

{
  "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 кілттеріңіздің статистикасы

Қол жеткізу: жеке кабинет токені

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

JSON / форма өрістері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`api_key_ids`	`array`	иә	required

Сұрау денесінің үлгісі

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

PLACEHOLDER енгізетін мәніңіз бен оның түрін білдіреді. Мәндерді ауыстырып, тек қажетті міндетті емес өрістерді қалдырыңыз; жолдық маркерлер сандардың, boolean мәндерінің, нысандардың немесе массивтердің орнына жіберілмейді.

Сұрау схемасы: BatchAPIKeysUsageRequest

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап деректерінің схемалары: BatchAPIKeyUsageStats. Өрістер мен түрлер «Деректер схемалары» беттерінде берілген.

Жауап схемасы, мәндері шартты

{
  "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 кілттеріңіздің статистикасын оқиды; мысал шартты сипаттайды және орындалмайды.

GET /api/v1/usage/dashboard/models — Модельдер бойынша пайдалану

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage/dashboard/models

Оқу; ID алдыңғы жауабыңыздан алынады

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

Query параметрлері

Өріс	Түрі	Міндетті
`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 мазмұны төмендегі схемаларда сипатталған.

Жауап схемасы, мәндері шартты

{
  "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 — Графиктердің бірыңғай сәттік көрінісі

Қол жеткізу: жеке кабинет токені

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

Оқу; ID алдыңғы жауабыңыздан алынады

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

Query параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`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 мазмұны төмендегі схемаларда сипатталған.

Жауап схемасы, мәндері шартты

{
  "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 — Пайдалану қорытындылары

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage/dashboard/stats

Оқу; ID алдыңғы жауабыңыздан алынады

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

Сұрау денесі қажет емес. Жоғарыда көрсетілген параметрлерді URL ішінде жіберіңіз.

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап деректерінің схемалары: UserDashboardStats. Өрістер мен түрлер «Деректер схемалары» беттерінде берілген.

Жауап схемасы, мәндері шартты

{
  "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 — Пайдалану динамикасы

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage/dashboard/trend

Оқу; ID алдыңғы жауабыңыздан алынады

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

Query параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`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 мазмұны төмендегі схемаларда сипатталған.

Жауап схемасы, мәндері шартты

{
  "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 — Қателер тарихы

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage/errors

Оқу; ID алдыңғы жауабыңыздан алынады

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

Query параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`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; positive; page_size/limit <=1000
`page_size`	`integer`	жоқ	; әдепкіде: 20; positive; page_size/limit <=1000
`limit`	`integer`	жоқ	; әдепкіде: 20; positive; page_size/limit <=1000

Сұрау денесі қажет емес. Жоғарыда көрсетілген параметрлерді URL ішінде жіберіңіз.

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап схемасы, мәндері шартты

{
  "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 — Өз қатеңіз туралы мәліметтер

Қол жеткізу: жеке кабинет токені

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

Оқу; ID алдыңғы жауабыңыздан алынады

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

Жол параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`id`	`integer`	иә

Сұрау денесі қажет емес. Жоғарыда көрсетілген параметрлерді URL ішінде жіберіңіз.

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап схемасы, мәндері шартты

{
  "code": 0,
  "message": "success",
  "data": "PLACEHOLDER_DATA (object, сипаттамасы «Деректер схемалары» бетінде)"
}

Ерекшеліктер: барлық жеке дерек пен нысан JWT субъектісімен шектелген.

GET /api/v1/usage/stats — Пайдалану статистикасы

Қол жеткізу: жеке кабинет токені

GET/api/v1/usage/stats

Оқу; ID алдыңғы жауабыңыздан алынады

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

Query параметрлері

Өріс	Түрі	Міндетті
`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. Өрістер мен түрлер «Деректер схемалары» беттерінде берілген.

Жауап схемасы, мәндері шартты

{
  "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 кілтіңіздің күндік статистикасы

Қол жеткізу: жеке кабинет токені

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

Оқу; ID алдыңғы жауабыңыздан алынады

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

Жол параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`id`	`integer`	иә

Query параметрлері

Өріс	Түрі	Міндетті	Тексеру / сипаттама
`days`	`integer`	жоқ	; әдепкіде: 30
`timezone`	`string`	жоқ

Сұрау денесі қажет емес. Жоғарыда көрсетілген параметрлерді URL ішінде жіберіңіз.

Жауап

JSON жауабында code, message және data бар. data мазмұны төмендегі схемаларда сипатталған.

Жауап деректерінің схемалары: APIKeyDailyUsagePoint. Өрістер мен түрлер «Деректер схемалары» беттерінде берілген.

Жауап схемасы, мәндері шартты

{
  "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 түрінде тіркелген есептен шығару сомасы.

Есептеу мысалы

{
  "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 мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.Қолдау қызметіне жазу