Source: https://ailoot.ai/docs/hu/cabinet/usage/ Canonical: https://ailoot.ai/docs/hu/cabinet/usage/ Language: hu [Fiók-API](https://ailoot.ai/docs/hu/) # Előzmények és költségek [Markdown](https://ailoot.ai/docs/hu/cabinet/usage/index.md) Metódusok, kérésmezők és válaszok. Ebben a részben 11 metódus található. Nyissa meg a metódust a hozzáférési feltételek, a kérésmezők és a válasz megtekintéséhez. | Metódus és útvonal | Leírás | Hozzáférés | | --- | --- | --- | | `GET /api/v1/usage` | Kérések előzményei | Fióktoken | | `GET /api/v1/usage/:id` | Egy kérés az előzményekből | Fióktoken | | `POST /api/v1/usage/dashboard/api-keys-usage` | Saját API-kulcsok statisztikái | Fióktoken | | `GET /api/v1/usage/dashboard/models` | Használat modellenként | Fióktoken | | `GET /api/v1/usage/dashboard/snapshot-v2` | Diagramok egységes pillanatképe | Fióktoken | | `GET /api/v1/usage/dashboard/stats` | Használati összesítés | Fióktoken | | `GET /api/v1/usage/dashboard/trend` | Használat időbeli alakulása | Fióktoken | | `GET /api/v1/usage/errors` | Hibaelőzmények | Fióktoken | | `GET /api/v1/usage/errors/:id` | Saját hiba részletei | Fióktoken | | `GET /api/v1/usage/stats` | Használati statisztikák | Fióktoken | | `GET /api/v1/user/api-keys/:id/usage/daily` | Saját API-kulcs napi statisztikái | Fióktoken | **GET /api/v1/usage** — Kérések előzményei Hozzáférés: fióktoken GET`/api/v1/usage` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage" \ -H "Authorization: Bearer $TOKEN" ``` ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `sort_by` | `string` | nem | ; alapértelmezés: created\_at | | `sort_order` | `string` | nem | ; alapértelmezés: desc | | `api_key_id` | `integer` | nem | | | `request_type` | `string` | nem | | | `stream` | `boolean` | nem | | | `timezone` | `string` | nem | | | `start_date` | `string` | nem | | | `end_date` | `string` | nem | | | `period` | `string` | nem | | | `model` | `string` | nem | | | `page` | `integer` | nem | ; alapértelmezés: 1; positive; page\_size/limit \<=1000 | | `page_size` | `integer` | nem | ; alapértelmezés: 20; positive; page\_size/limit \<=1000 | | `limit` | `integer` | nem | ; alapértelmezés: 20; positive; page\_size/limit \<=1000 | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. A válasz adatsémái: `UsageLog`. A mezők és típusok az „Adatsémák” oldalain találhatók. Válaszséma, szemléltető értékekkel ```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)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/:id** — Egy kérés az előzményekből Hozzáférés: fióktoken GET`/api/v1/usage/:id` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/$ID" \ -H "Authorization: Bearer $TOKEN" ``` ## Útvonalparaméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `id` | `integer` | igen | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. A válasz adatsémái: `UsageLog`. A mezők és típusok az „Adatsémák” oldalain találhatók. Válaszséma, szemléltető értékekkel ```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)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **POST /api/v1/usage/dashboard/api-keys-usage** — Saját API-kulcsok statisztikái Hozzáférés: fióktoken POST`/api/v1/usage/dashboard/api-keys-usage` ## JSON- / űrlapmezők | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `api_key_ids` | `array` | igen | required | Kéréstörzs-sablon ```json { "api_key_ids": "PLACEHOLDER_API_KEY_IDS (array)" } ``` A PLACEHOLDER az Ön által megadandó értéket és annak típusát jelöli. Cserélje ki az értékeket, és csak a szükséges nem kötelező mezőket tartsa meg; karakterlánc-jelölők nem küldhetők számok, boolean értékek, objektumok vagy tömbök helyett. A kérés sémája: `BatchAPIKeysUsageRequest` ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. A válasz adatsémái: `BatchAPIKeyUsageStats`. A mezők és típusok az „Adatsémák” oldalain találhatók. Válaszséma, szemléltető értékekkel ```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)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. Sajátosságok: a metódus a saját API-kulcsok statisztikáit olvassa; a példa a szerződést írja le, és nem kerül végrehajtásra. A metódus statisztikát ad vissza, és nem módosítja az API-kulcsokat vagy a költségeket. Az ismételt lekérdezéshez az Idempotency-Key nem szükséges; a válasz a kérés időpontjában érvényes állapotot tükrözi. **GET /api/v1/usage/dashboard/models** — Használat modellenként Hozzáférés: fióktoken GET`/api/v1/usage/dashboard/models` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/models" \ -H "Authorization: Bearer $TOKEN" ``` ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `api_key_id` | `integer` | nem | | | `request_type` | `string` | nem | | | `stream` | `boolean` | nem | | | `timezone` | `string` | nem | | | `start_date` | `string` | nem | | | `end_date` | `string` | nem | | | `period` | `string` | nem | | | `model` | `string` | nem | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. Válaszséma, szemléltető értékekkel ```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" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/dashboard/snapshot-v2** — Diagramok egységes pillanatképe Hozzáférés: fióktoken GET`/api/v1/usage/dashboard/snapshot-v2` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/snapshot-v2" \ -H "Authorization: Bearer $TOKEN" ``` ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `granularity` | `string` | nem | ; alapértelmezés: day | | `include_trend` | `boolean` | nem | ; alapértelmezés: true | | `include_model_stats` | `boolean` | nem | ; alapértelmezés: true | | `api_key_id` | `integer` | nem | | | `request_type` | `string` | nem | | | `stream` | `boolean` | nem | | | `timezone` | `string` | nem | | | `start_date` | `string` | nem | | | `end_date` | `string` | nem | | | `period` | `string` | nem | | | `model` | `string` | nem | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. Válaszséma, szemléltető értékekkel ```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" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/dashboard/stats** — Használati összesítés Hozzáférés: fióktoken GET`/api/v1/usage/dashboard/stats` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/stats" \ -H "Authorization: Bearer $TOKEN" ``` A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. A válasz adatsémái: `UserDashboardStats`. A mezők és típusok az „Adatsémák” oldalain találhatók. Válaszséma, szemléltető értékekkel ```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)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/dashboard/trend** — Használat időbeli alakulása Hozzáférés: fióktoken GET`/api/v1/usage/dashboard/trend` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/dashboard/trend" \ -H "Authorization: Bearer $TOKEN" ``` ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `granularity` | `string` | nem | ; alapértelmezés: day | | `api_key_id` | `integer` | nem | | | `request_type` | `string` | nem | | | `stream` | `boolean` | nem | | | `timezone` | `string` | nem | | | `start_date` | `string` | nem | | | `end_date` | `string` | nem | | | `period` | `string` | nem | | | `model` | `string` | nem | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. Válaszséma, szemléltető értékekkel ```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" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/errors** — Hibaelőzmények Hozzáférés: fióktoken GET`/api/v1/usage/errors` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/errors" \ -H "Authorization: Bearer $TOKEN" ``` ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `timezone` | `string` | nem | | | `start_date` | `string` | nem | | | `end_date` | `string` | nem | | | `model` | `string` | nem | | | `api_key_id` | `integer` | nem | | | `status_code` | `integer` | nem | | | `category` | `string` | nem | | | `sort_by` | `string` | nem | | | `sort_order` | `string` | nem | | | `page` | `integer` | nem | ; alapértelmezés: 1; positive; page\_size/limit \<=1000 | | `page_size` | `integer` | nem | ; alapértelmezés: 20; positive; page\_size/limit \<=1000 | | `limit` | `integer` | nem | ; alapértelmezés: 20; positive; page\_size/limit \<=1000 | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. Válaszséma, szemléltető értékekkel ```json { "code": 0, "message": "success", "data": { "items": [ "PLACEHOLDER_DATA (object, leírás az «Adatsémák» oldalon)" ], "total": "PLACEHOLDER_TOTAL (integer)", "page": "PLACEHOLDER_PAGE (integer)", "page_size": "PLACEHOLDER_PAGE_SIZE (integer)", "pages": "PLACEHOLDER_PAGES (integer)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/errors/:id** — Saját hiba részletei Hozzáférés: fióktoken GET`/api/v1/usage/errors/:id` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/errors/$ID" \ -H "Authorization: Bearer $TOKEN" ``` ## Útvonalparaméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `id` | `integer` | igen | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. Válaszséma, szemléltető értékekkel ```json { "code": 0, "message": "success", "data": "PLACEHOLDER_DATA (object, leírás az «Adatsémák» oldalon)" } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/usage/stats** — Használati statisztikák Hozzáférés: fióktoken GET`/api/v1/usage/stats` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/usage/stats" \ -H "Authorization: Bearer $TOKEN" ``` ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `api_key_id` | `integer` | nem | | | `request_type` | `string` | nem | | | `stream` | `boolean` | nem | | | `timezone` | `string` | nem | | | `start_date` | `string` | nem | | | `end_date` | `string` | nem | | | `period` | `string` | nem | | | `model` | `string` | nem | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. A válasz adatsémái: `UsageStats`. A mezők és típusok az „Adatsémák” oldalain találhatók. Válaszséma, szemléltető értékekkel ```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)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. **GET /api/v1/user/api-keys/:id/usage/daily** — Saját API-kulcs napi statisztikái Hozzáférés: fióktoken GET`/api/v1/user/api-keys/:id/usage/daily` Olvasás; az azonosító a korábbi válaszából származik ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/api-keys/$ID/usage/daily" \ -H "Authorization: Bearer $TOKEN" ``` ## Útvonalparaméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `id` | `integer` | igen | | ## Query-paraméterek | Mező: | Típus | Kötelező | Ellenőrzés / leírás | | --- | --- | --- | --- | | `days` | `integer` | nem | ; alapértelmezés: 30 | | `timezone` | `string` | nem | | A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg. ## Válasz A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le. A válasz adatsémái: `APIKeyDailyUsagePoint`. A mezők és típusok az „Adatsémák” oldalain találhatók. Válaszséma, szemléltető értékekkel ```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)" } } ``` Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött. ## Előzmények és költségek · USD A total\_cost a tarifa alapján számított költség; az actual\_cost a nyilvántartott terhelés USD-ben. ### Számítási példa ```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`. Maradt kérdése? Küldje el a Request ID-t és a probléma leírását — segítünk tisztázni.[Írjon a támogatásnak](mailto:support@ailoot.ai) ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.