dokumentace
API uživatelského panelu

API uživatelského panelu

Markdown

Metody 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-…)
CoAdresaAutorizace
API uživatelského paneluhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN – token uživatelského panelu po přihlášení
API modelůhttps://api.ailoot.ai/v1Klíč 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.

Načtení vlastního profilu
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.

Struktura stránkované odpovědi
{
  "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.

Seznam a vlastní klíč
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.

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.Napsat podpoře