API แดชบอร์ด — เอกสาร Ailoot

เมธอดของแดชบอร์ดส่วนตัว: การเข้าสู่ระบบ โปรไฟล์ คีย์ และประวัติค่าใช้จ่าย

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

ที่อยู่และการยืนยันสิทธิ์

แดชบอร์ด: https://ailoot.ai (เข้าสู่ระบบด้วยข้อมูลล็อกอิน ใช้โทเคนแดชบอร์ด)
API โมเดล: https://api.ailoot.ai (คีย์ sk-…)

หัวข้อ	ที่อยู่	การยืนยันสิทธิ์
API แผงควบคุม	`https://ailoot.ai/api/v1`	`Authorization: Bearer $TOKEN` — โทเคนแดชบอร์ดหลังเข้าสู่ระบบ
API โมเดล	`https://api.ailoot.ai/v1`	คีย์ `sk-…` จากส่วน “API-ключи”; ดู คีย์และที่อยู่ API

คีย์ sk-… ใช้แทนโทเคนแดชบอร์ดไม่ได้ และโทเคนแดชบอร์ดก็ใช้เข้าถึง API โมเดลไม่ได้ ดูพาธเต็มได้ที่แต่ละเมธอด

อ่านโปรไฟล์ของตนเอง

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

รูปแบบคำตอบและข้อผิดพลาด

คำตอบมี code, message และ data ข้อผิดพลาดอาจมี reason และ metadata การแบ่งหน้าใน data มี items, total, page, page_size และ pages ดูรูปแบบเฉพาะของแต่ละเมธอดได้ในคำอธิบาย

โครงสร้างคำตอบแบบแบ่งหน้า

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

ระบบตรวจ⁠สอบโทเคนแดชบอร์ดตามวันหมดอายุและสถานะเปิดใช้งานของผู้ใช้ หากเปิดใช้การผูกเซสชัน จะตรวจ⁠สอบ IP และเบราว์เซอร์ด้วย รหัส TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN และ FORBIDDEN แยกปัญหาเซสชันออกจากปัญหาสิทธิ์ ขีดจำกัดอัตราและการยืนยัน 2FA เพิ่มเติมอาจทำให้คำขอบางรายการถูกปฏิเสธ

วิธีอ่านเอกสารอ้างอิง

แต่ละรายการระบุเมธอด HTTP พาธเต็ม การเข้าถึง พารามิเตอร์ ฟิลด์เนื้อหาคำขอ และคำตอบ
ใช้รหัสจากคำตอบก่อนหน้า: KEY_ID จาก GET /api/v1/keys และ ID คำขอจาก GET /api/v1/usage
ดูฟิลด์ของออบเจ็กต์และชนิดข้อมูลได้ในหน้า “โครงสร้างข้อมูล”
เทมเพลตแสดงชื่อและชนิดของฟิลด์ PLACEHOLDER และ TOKEN เป็นตัวแทนค่า ไม่มีข้อมูลจริงอยู่ในตัวอย่างนี้
เติมเงินได้ในส่วน “อัตราค่าบริการ” ของแดชบอร์ด: วิธีเติมเงิน.

ยอดคงเหลือและ frozen_balance

โปรไฟล์มี balance และ frozen_balance โดย frozen_balance คือเงินที่กันไว้สำหรับคำขอที่ยังไม่เสร็จ ตรวจ⁠สอบทั้งสองฟิลด์ควบคู่กับประวัติ

คีย์และขีดจำกัด

GET /api/v1/keys ส่งกลับคีย์ของคุณ ฟิลด์ quota และ quota_used — คือวงเงินค่าใช้จ่ายของคีย์และจำนวนที่ใช้ไปแล้ว ส่วน ip_whitelist, ip_blacklist, status และ expires_at ควบคุมการใช้งานคีย์ และ rate_limit_5h, rate_limit_1d และ rate_limit_7d — คือขีดจำกัดค่าใช้จ่ายตามช่วงเวลา

รายการและคีย์ของตนเอง

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

# KEY_ID คือ id ของคีย์ของคุณเองที่ได้จากคำตอบของคำขอรายการคีย์
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

ค่าใช้จ่ายและความปลอดภัย

ประวัติและ dashboard แสดง actual_cost ซึ่งเป็นจำนวนเงินที่หักจริง ส่วน total_cost คือค่าใช้จ่ายตามราคามาตรฐาน ตัวกรองวันที่ โมเดล คีย์ และประเภทคำขอระบุไว้ที่เมธอด การเปลี่ยนรหัสผ่าน TOTP และ passkey ต้องใช้การยืนยันตามที่อธิบายไว้ในเมธอดนั้น ๆ

ในส่วนนี้: 39 เมธอด

ยังมีคำถามอยู่ใช่ไหม ส่ง Request ID และรายละเอียดมาให้เรา เราจะช่วยตรวจ⁠สอบติดต่อฝ่ายสนับสนุน

API แผงควบคุม