hujjatlar
Boshqaruv paneli API

Boshqaruv paneli API

Markdown

Boshqaruv paneli metodlari: kirish, profil, kalitlar va sarflar tarixi.

To‘liq qo‘llanma

Manzillar va avtorizatsiya

  • Boshqaruv paneli: https://ailoot.ai (login bilan kirish, boshqaruv paneli tokeni)
  • Modellar API’si: https://api.ailoot.ai (sk-… kaliti)
NimaManzilAvtorizatsiya
Boshqaruv paneli APIhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — tizimga kirgandan keyingi boshqaruv paneli tokeni
Modellar API’sihttps://api.ailoot.ai/v1Kalit sk-… «API kalitlari» bo‘limidan; qarang: Kalitlar va API manzili

Kalit sk-… boshqaruv paneli tokenining o‘rnini bosmaydi, boshqaruv paneli tokeni esa modellar API’siga kirishni ta’minlamaydi. To‘liq yo‘l har bir metod uchun ko‘rsatilgan.

O‘z profilingizni o‘qish
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Javob formati va xatolar

Javob code, message va data’ni o‘z ichiga oladi. Xatoda reason va metadata bo‘lishi mumkin. data’dagi sahifalash items, total, page, page_size va pages’ni o‘z ichiga oladi. Alohida metodlarning formati ularning tavsifida berilgan.

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

Boshqaruv paneli tokenining amal qilish muddati va foydalanuvchining faolligi tekshiriladi; seansni bog‘lash yoqilgan bo‘lsa, IP va brauzer ham tekshiriladi. TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN va FORBIDDEN kodlari seans va huquqlar bilan bog‘liq muammolarni farqlaydi. Chastota limiti va qo‘shimcha 2FA tasdig‘i alohida so‘rovni bloklashi mumkin.

Ma’lumotnomadan qanday foydalanish kerak

  • Har bir yozuvda HTTP metodi, to‘liq yo‘l, kirish shartlari, parametrlar, tana maydonlari va javob berilgan.
  • Identifikatorlarni oldingi javobdan oling: KEY_ID — GET /api/v1/keys’dan, so‘rov ID’si — GET /api/v1/usage’dan.
  • Obyekt maydonlari va ularning turlari «Ma’lumotlar sxemalari» sahifalarida berilgan.
  • Shablonlar maydon nomlari va turlarini ko‘rsatadi. PLACEHOLDER va TOKEN — belgilar; bu yerda haqiqiy ma’lumotlar yo‘q.
  • Balansni to‘ldirish — boshqaruv panelining «Tariflar» bo‘limida: qanday to‘ldirish kerak.

Balans va frozen_balance

Profil balance va frozen_balance’ni o‘z ichiga oladi. frozen_balance — yakunlanmagan so‘rovlar uchun zaxiraga olingan summa. Ikkala maydonni ham tarix bilan birga tekshiring.

Kalitlar va limitlar

GET /api/v1/keys kalitlaringizni qaytaradi. Maydonlar quota va quota_used — kalitning sarf limiti va allaqachon sarflangan qismi; ip_whitelist, ip_blacklist, status va expires_at kalitdan foydalanishni boshqaradi; rate_limit_5h, rate_limit_1d va rate_limit_7d — sarf davrlari uchun sarf limitlari.

Ro‘yxat va o‘z kalitingiz
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — ro‘yxat javobidagi o‘zingizga tegishli kalitning id qiymati
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Sarflar va xavfsizlik

Tarix va boshqaruv panelida actual_cost — haqiqiy yechib olingan summa, total_cost esa standart narx bo‘yicha qiymat ko‘rsatiladi. Sana, model, kalit va so‘rov turi filtrlari metod tavsifida berilgan. Parolni o‘zgartirish, TOTP va passkey tegishli metodlarda bayon qilingan tasdiqlarni talab qiladi.

Bu bo‘limda: 39 ta metod.

Savollaringiz qoldimi? Request ID va tavsifni yuboring — tushunishga yordam beramiz.Yordam xizmatiga yozish