dokumentácia
API používateľského účtu

API používateľského účtu

Markdown

Metódy používateľského účtu: prihlásenie, profil, kľúče a história výdavkov.

Úplný sprievodca

Adresy a autorizácia

  • Používateľský účet: https://ailoot.ai (prihlásenie prihlasovacími údajmi, token účtu)
  • API modelov: https://api.ailoot.ai (kľúč sk-…)
ČoAdresaAutorizácia
API používateľského účtuhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN – token účtu po prihlásení
API modelovhttps://api.ailoot.ai/v1Kľúč sk-… zo sekcie „API kľúče“; pozri Kľúče a adresa API

Kľúč sk-… nenahrádza token účtu a token účtu neumožňuje prístup k API modelov. Úplná cesta je uvedená pri každej metóde.

Načítanie vlastného profilu
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Formát odpovede a chyby

Odpoveď obsahuje code, message a data. Chyba môže obsahovať reason a metadata. Stránkovanie v data obsahuje items, total, page, page_size a pages. Formát jednotlivých metód je uvedený v ich opise.

Štruktúra stránkovanej odpovede
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

Pri tokene účtu sa kontroluje platnosť a aktivita používateľa; ak je zapnutá väzba relácie, aj IP a prehliadač. Kódy TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN a FORBIDDEN rozlišujú problémy relácie a oprávnení. Limit frekvencie a dodatočné potvrdenie 2FA môžu zablokovať konkrétnu požiadavku.

Ako čítať referenčnú príručku

  • Každá položka obsahuje HTTP metódu, úplnú cestu, prístup, parametre, polia tela a odpoveď.
  • Identifikátory preberajte z predchádzajúcej odpovede: KEY_ID z GET /api/v1/keys, ID požiadavky z GET /api/v1/usage.
  • Polia objektov a ich typy nájdete na stránkach „Dátové schémy“.
  • Šablóny ukazujú názvy a typy polí. PLACEHOLDER a TOKEN sú zástupné označenia, nejde o skutočné údaje.
  • Dobitie kreditu je v sekcii „Cenník“ používateľského účtu: ako dobiť kredit.

Zostatok a frozen_balance

Profil obsahuje balance a frozen_balance. frozen_balance je suma rezervovaná na nedokončené požiadavky. Obe polia kontrolujte spolu s históriou.

Kľúče a limity

GET /api/v1/keys vracia vaše kľúče. Polia quota a quota_used – limit výdavkov kľúča a už minutá časť; ip_whitelist, ip_blacklist, status a expires_at riadia používanie kľúča; rate_limit_5h, rate_limit_1d a rate_limit_7d – limity výdavkov za časové okná.

Zoznam a vlastný kľúč
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID je id vášho vlastného kľúča z odpovede so zoznamom
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Výdavky a zabezpečenie

História a dashboard zobrazujú actual_cost – skutočne zaúčtovanú sumu; total_cost – cenu podľa štandardného cenníka. Filtre dátumu, modelu, kľúča a typu požiadavky sú uvedené pri metóde. Zmena hesla, TOTP a passkey vyžadujú potvrdenia opísané pri príslušných metódach.

V tejto sekcii: 39 metód.

Máte ďalšie otázky? Pošlite Request ID a opis problému – pomôžeme vám ho vyriešiť.Napísať podpore