Sejarah dan perbelanjaan

Kaedah, medan permintaan dan respons.

Panduan lengkap

Bahagian ini mengandungi 11 kaedah. Buka kaedah untuk melihat syarat akses, medan permintaan dan respons.

Kaedah dan laluan	Penerangan	Akses
`GET /api/v1/usage`	Sejarah permintaan	Token panel pengguna
`GET /api/v1/usage/:id`	Satu permintaan daripada sejarah	Token panel pengguna
`POST /api/v1/usage/dashboard/api-keys-usage`	Statistik kunci API sendiri	Token panel pengguna
`GET /api/v1/usage/dashboard/models`	Penggunaan mengikut model	Token panel pengguna
`GET /api/v1/usage/dashboard/snapshot-v2`	Petikan keadaan bersepadu bagi carta	Token panel pengguna
`GET /api/v1/usage/dashboard/stats`	Ringkasan penggunaan	Token panel pengguna
`GET /api/v1/usage/dashboard/trend`	Trend penggunaan	Token panel pengguna
`GET /api/v1/usage/errors`	Sejarah ralat	Token panel pengguna
`GET /api/v1/usage/errors/:id`	Butiran ralat sendiri	Token panel pengguna
`GET /api/v1/usage/stats`	Statistik penggunaan	Token panel pengguna
`GET /api/v1/user/api-keys/:id/usage/daily`	Statistik harian kunci API sendiri	Token panel pengguna

GET /api/v1/usage — Sejarah permintaan

Akses: Token panel pengguna

GET/api/v1/usage

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter pertanyaan

Medan	Jenis	Wajib	Pengesahan / penerangan
`sort_by`	`string`	tidak	; nilai lalai: created_at
`sort_order`	`string`	tidak	; nilai lalai: desc
`api_key_id`	`integer`	tidak
`request_type`	`string`	tidak
`stream`	`boolean`	tidak
`timezone`	`string`	tidak
`start_date`	`string`	tidak
`end_date`	`string`	tidak
`period`	`string`	tidak
`model`	`string`	tidak
`page`	`integer`	tidak	; nilai lalai: 1; positive; page_size/limit <=1000
`page_size`	`integer`	tidak	; nilai lalai: 20; positive; page_size/limit <=1000
`limit`	`integer`	tidak	; nilai lalai: 20; positive; page_size/limit <=1000

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: UsageLog. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/:id — Satu permintaan daripada sejarah

Akses: Token panel pengguna

GET/api/v1/usage/:id

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter laluan

Medan	Jenis	Wajib	Pengesahan / penerangan
`id`	`integer`	ya

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: UsageLog. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

POST /api/v1/usage/dashboard/api-keys-usage — Statistik kunci API sendiri

Akses: Token panel pengguna

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

Medan JSON / borang

Medan	Jenis	Wajib	Pengesahan / penerangan
`api_key_ids`	`array`	ya	required

Templat badan permintaan

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

PLACEHOLDER mewakili input anda dan jenisnya. Gantikan nilai dan kekalkan hanya medan pilihan yang diperlukan; penanda rentetan tidak boleh dihantar sebagai ganti nombor, boolean, objek atau tatasusunan.

Skema permintaan: BatchAPIKeysUsageRequest

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: BatchAPIKeyUsageStats. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

Nota: Kaedah ini membaca statistik kunci API milik sendiri; contoh ini menerangkan kontrak dan tidak dijalankan.

GET /api/v1/usage/dashboard/models — Penggunaan mengikut model

Akses: Token panel pengguna

GET/api/v1/usage/dashboard/models

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter pertanyaan

Medan	Jenis	Wajib
`api_key_id`	`integer`	tidak
`request_type`	`string`	tidak
`stream`	`boolean`	tidak
`timezone`	`string`	tidak
`start_date`	`string`	tidak
`end_date`	`string`	tidak
`period`	`string`	tidak
`model`	`string`	tidak

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/dashboard/snapshot-v2 — Petikan keadaan bersepadu bagi carta

Akses: Token panel pengguna

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

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter pertanyaan

Medan	Jenis	Wajib	Pengesahan / penerangan
`granularity`	`string`	tidak	; nilai lalai: day
`include_trend`	`boolean`	tidak	; nilai lalai: true
`include_model_stats`	`boolean`	tidak	; nilai lalai: true
`api_key_id`	`integer`	tidak
`request_type`	`string`	tidak
`stream`	`boolean`	tidak
`timezone`	`string`	tidak
`start_date`	`string`	tidak
`end_date`	`string`	tidak
`period`	`string`	tidak
`model`	`string`	tidak

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/dashboard/stats — Ringkasan penggunaan

Akses: Token panel pengguna

GET/api/v1/usage/dashboard/stats

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: UserDashboardStats. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/dashboard/trend — Trend penggunaan

Akses: Token panel pengguna

GET/api/v1/usage/dashboard/trend

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter pertanyaan

Medan	Jenis	Wajib	Pengesahan / penerangan
`granularity`	`string`	tidak	; nilai lalai: day
`api_key_id`	`integer`	tidak
`request_type`	`string`	tidak
`stream`	`boolean`	tidak
`timezone`	`string`	tidak
`start_date`	`string`	tidak
`end_date`	`string`	tidak
`period`	`string`	tidak
`model`	`string`	tidak

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/errors — Sejarah ralat

Akses: Token panel pengguna

GET/api/v1/usage/errors

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter pertanyaan

Medan	Jenis	Wajib	Pengesahan / penerangan
`timezone`	`string`	tidak
`start_date`	`string`	tidak
`end_date`	`string`	tidak
`model`	`string`	tidak
`api_key_id`	`integer`	tidak
`status_code`	`integer`	tidak
`category`	`string`	tidak
`sort_by`	`string`	tidak
`sort_order`	`string`	tidak
`page`	`integer`	tidak	; nilai lalai: 1; positive; page_size/limit <=1000
`page_size`	`integer`	tidak	; nilai lalai: 20; positive; page_size/limit <=1000
`limit`	`integer`	tidak	; nilai lalai: 20; positive; page_size/limit <=1000

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema respons, nilai hanyalah contoh

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      "PLACEHOLDER_DATA (object, penerangan — pada halaman «Skema data»)"
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/errors/:id — Butiran ralat sendiri

Akses: Token panel pengguna

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

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter laluan

Medan	Jenis	Wajib	Pengesahan / penerangan
`id`	`integer`	ya

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema respons, nilai hanyalah contoh

{
  "code": 0,
  "message": "success",
  "data": "PLACEHOLDER_DATA (object, penerangan — pada halaman «Skema data»)"
}

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/usage/stats — Statistik penggunaan

Akses: Token panel pengguna

GET/api/v1/usage/stats

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter pertanyaan

Medan	Jenis	Wajib
`api_key_id`	`integer`	tidak
`request_type`	`string`	tidak
`stream`	`boolean`	tidak
`timezone`	`string`	tidak
`start_date`	`string`	tidak
`end_date`	`string`	tidak
`period`	`string`	tidak
`model`	`string`	tidak

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: UsageStats. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

GET /api/v1/user/api-keys/:id/usage/daily — Statistik harian kunci API sendiri

Akses: Token panel pengguna

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

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

Parameter laluan

Medan	Jenis	Wajib	Pengesahan / penerangan
`id`	`integer`	ya

Parameter pertanyaan

Medan	Jenis	Wajib	Pengesahan / penerangan
`days`	`integer`	tidak	; nilai lalai: 30
`timezone`	`string`	tidak

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: APIKeyDailyUsagePoint. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

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

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

Sejarah dan perbelanjaan · USD

total_cost ialah kos yang dikira mengikut tarif; actual_cost ialah caj yang direkodkan dalam USD.

Contoh pengiraan

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

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.Hubungi sokongan