ประวัติและค่าใช้จ่าย

เมธอด ฟิลด์คำขอ และคำตอบ

คู่มือฉบับเต็ม

ส่วนนี้มี 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 อธิบายไว้ในสคีมาด้านล่าง

สคีมาคำตอบ โดยค่าเป็นเพียงตัวอย่าง

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

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

ลักษณะเฉพาะ: เมธอดนี้อ่านสถิติของคีย์ API ที่คุณเป็นเจ้าของ ตัวอย่างอธิบายสัญญา 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"
  }
}

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

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

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

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

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, ดูคำอธิบายที่หน้า «สคีมาข้อมูล»)"
}

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

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

ประวัติและค่าใช้จ่าย · 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 และรายละเอียดมาให้เรา เราจะช่วยตรวจ⁠สอบติดต่อฝ่ายสนับสนุน