dokumentasi
API panel pengguna

API panel pengguna

Markdown

Kaedah panel pengguna: log masuk, profil, kunci dan sejarah perbelanjaan.

Panduan lengkap

Alamat dan pengesahan

  • Panel pengguna: https://ailoot.ai (log masuk akaun, token panel pengguna)
  • API model: https://api.ailoot.ai (kunci sk-…)
PerkaraAlamatPengesahan
API panel penggunahttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — token panel pengguna selepas log masuk
API modelhttps://api.ailoot.ai/v1Kunci sk-… daripada bahagian “Kunci API”; lihat Kunci dan alamat API

Kunci sk-… tidak menggantikan token panel pengguna, dan token panel pengguna tidak memberikan akses kepada API model. Laluan penuh dinyatakan bagi setiap kaedah.

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

Format respons dan ralat

Respons mengandungi code, message dan data. Ralat mungkin mengandungi reason dan metadata. Penomboran halaman dalam data mengandungi items, total, page, page_size dan pages. Format setiap kaedah dinyatakan dalam penerangannya.

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

Token panel pengguna diperiksa berdasarkan tempoh sahnya dan sama ada pengguna aktif; jika pengikatan sesi diaktifkan, IP dan pelayar turut diperiksa. Kod TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN dan FORBIDDEN membezakan masalah sesi dan hak akses. Had kadar dan pengesahan 2FA tambahan boleh menyekat permintaan tertentu.

Cara membaca rujukan

  • Setiap entri mengandungi kaedah HTTP, laluan penuh, akses, parameter, medan badan permintaan dan respons.
  • Ambil pengecam daripada respons terdahulu: KEY_ID — daripada GET /api/v1/keys, ID permintaan — daripada GET /api/v1/usage.
  • Medan objek dan jenisnya terdapat pada halaman “Skema data”.
  • Templat menunjukkan nama dan jenis medan. PLACEHOLDER dan TOKEN ialah penanda; tiada data sebenar di sini.
  • Tambah nilai baki terdapat dalam bahagian “Pelan harga” panel pengguna: cara menambah nilai.

Baki dan frozen_balance

Profil mengandungi balance dan frozen_balance. frozen_balance ialah amaun yang dirizabkan untuk permintaan yang belum selesai. Semak kedua-dua medan bersama sejarah.

Kunci dan had

GET /api/v1/keys mengembalikan kunci anda. Medan quota dan quota_used — had perbelanjaan kunci dan bahagian yang sudah dibelanjakan; ip_whitelist, ip_blacklist, status dan expires_at mengawal penggunaan kunci; rate_limit_5h, rate_limit_1d dan rate_limit_7d — had perbelanjaan mengikut tetingkap masa.

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

# KEY_ID ialah id kunci milik anda daripada respons senarai
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Perbelanjaan dan keselamatan

Sejarah dan dashboard memaparkan actual_cost — caj sebenar; total_cost — kos pada harga standard. Penapis tarikh, model, kunci dan jenis permintaan dinyatakan pada kaedah. Pertukaran kata laluan, TOTP dan passkey memerlukan pengesahan yang diterangkan pada kaedah berkenaan.

Dalam bahagian ini: 39 kaedah.

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