API používateľského účtu
MarkdownMetó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-…)
| Čo | Adresa | Autorizácia |
|---|---|---|
| API používateľského účtu | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN – token účtu po prihlásení |
| API modelov | https://api.ailoot.ai/v1 | Kľúč 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.
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.
{
"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á.
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.