API uživatelského panelu
MarkdownMetody uživatelského panelu: přihlášení, profil, klíče a historie nákladů.
Úplný průvodce
Adresy a autorizace
- Uživatelský panel: https://ailoot.ai (přihlášení pomocí přihlašovacího jména, token uživatelského panelu)
- API modelů: https://api.ailoot.ai (klíč sk-…)
| Co | Adresa | Autorizace |
|---|---|---|
| API uživatelského panelu | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN – token uživatelského panelu po přihlášení |
| API modelů | https://api.ailoot.ai/v1 | Klíč sk-… ze sekce „Klíče API“; viz Klíče a adresa API |
Klíč sk-… nenahrazuje token uživatelského panelu a token uživatelského panelu neumožňuje přístup k API modelů. Úplná cesta je uvedena u každé metody.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"Formát odpovědi a chyby
Odpověď obsahuje code, message a data. Chybová odpověď může obsahovat reason a metadata. Stránkování v data zahrnuje items, total, page, page_size a pages. Formát jednotlivých metod je uveden v jejich popisu.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}U tokenu uživatelského panelu se kontroluje platnost a to, zda je uživatel aktivní; pokud je zapnuto vázání relace, kontroluje se také IP adresa a prohlížeč. Kódy TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN a FORBIDDEN rozlišují problémy s relací a oprávněními. Omezení četnosti požadavků a dodatečné ověření pomocí 2FA mohou jednotlivý požadavek zablokovat.
Jak číst referenční příručku
- Každá položka obsahuje metodu HTTP, úplnou cestu, informace o přístupu, parametry, pole těla požadavku a odpověď.
- Identifikátory převezměte z předchozí odpovědi: KEY_ID – z GET /api/v1/keys, ID požadavku – z GET /api/v1/usage.
- Pole objektů a jejich typy najdete na stránkách „Datová schémata“.
- Šablony ukazují názvy a typy polí. PLACEHOLDER a TOKEN jsou zástupné značky, skutečné údaje zde nejsou.
- Zůstatek doplníte v sekci „Tarify“ uživatelského panelu: jak doplnit zůstatek.
Zůstatek a frozen_balance
Profil obsahuje balance a frozen_balance. frozen_balance je částka rezervovaná pro nedokončené požadavky. Kontrolujte obě pole společně s historií.
Klíče a limity
GET /api/v1/keys vrací vaše klíče. Pole quota a quota_used – limit útraty klíče a již utracená část; ip_whitelist, ip_blacklist, status a expires_at řídí použití klíče; rate_limit_5h, rate_limit_1d a rate_limit_7d – limity útraty za jednotlivá časová okna.
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
-H "Authorization: Bearer $TOKEN"
# KEY_ID je id vašeho vlastního klíče z odpovědi se seznamem
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
-H "Authorization: Bearer $TOKEN"Náklady a zabezpečení
Historie a dashboard zobrazují actual_cost – skutečně odečtenou částku; total_cost – náklady podle standardní ceny. Filtry podle data, modelu, klíče a typu požadavku jsou uvedeny u dané metody. Změna hesla, TOTP a passkey vyžadují potvrzení popsaná u příslušných metod.
V této sekci: 39 metod.