Source: https://ailoot.ai/docs/cs/cabinet/
Canonical: https://ailoot.ai/docs/cs/cabinet/
Language: cs

[API uživatelského panelu](https://ailoot.ai/docs/cs/) 

# API uživatelského panelu

[Markdown](https://ailoot.ai/docs/cs/cabinet/index.md)

Metody uživatelského panelu: přihlášení, profil, klíče a historie nákladů.

Jde o API uživatelského panelu ailoot.ai: přihlášení, profil, klíče a historie nákladů. Požadavky na modely se posílají na jinou adresu – `https://api.ailoot.ai` s klíčem `sk-…`. Přístup k metodám závisí na oprávněních vašeho účtu a aktivovaných funkcích.

## [](https://ailoot.ai/docs/cs/cabinet/#adresa-i-avtorizatsiya)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](https://ailoot.ai/docs/cs/keys/) |

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

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/cs/cabinet/#format-otveta-i-oshibki)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

```json
{
  "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.

## [](https://ailoot.ai/docs/cs/cabinet/#kak-chitat-spravochnik)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](https://ailoot.ai/docs/cs/billing/topup/).

## [](https://ailoot.ai/docs/cs/cabinet/#balans-i-frozen-balance)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í.

## [](https://ailoot.ai/docs/cs/cabinet/#klyuchi-i-limity)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íč

```bash
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"
```

## [](https://ailoot.ai/docs/cs/cabinet/#rashody-i-bezopasnost)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](mailto:support@ailoot.ai)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.