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

[API nadzorne plošče](https://ailoot.ai/docs/sl/) 

# API nadzorne plošče

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

Metode uporabniške nadzorne plošče: prijava, profil, ključi in zgodovina stroškov.

To je API uporabniške nadzorne plošče ailoot.ai: prijava, profil, ključi in zgodovina stroškov. Zahteve za modele se pošiljajo na drug naslov – `https://api.ailoot.ai` s ključem `sk-…`. Dostop do metod je odvisen od pravic vašega računa in omogočenih funkcij.

## [](https://ailoot.ai/docs/sl/cabinet/#adresa-i-avtorizatsiya)Naslovi in avtentikacija

- Nadzorna plošča: https://ailoot.ai (prijava z uporabniškim imenom, žeton nadzorne plošče)
- API modelov: https://api.ailoot.ai (ključ sk-…)

| Kaj | Naslov | Avtentikacija |
| --- | --- | --- |
| API nadzorne plošče | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` – žeton nadzorne plošče po prijavi |
| API modelov | `https://api.ailoot.ai/v1` | Ključ `sk-…` iz razdelka »Ključi API«; glejte [Ključi in naslov API-ja](https://ailoot.ai/docs/sl/keys/) |

Ključ `sk-…` ne nadomesti žetona nadzorne plošče, žeton nadzorne plošče pa ne omogoča dostopa do API-ja modelov. Celotna pot je navedena pri vsaki metodi.

Branje lastnega profila

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

## [](https://ailoot.ai/docs/sl/cabinet/#format-otveta-i-oshibki)Format odgovora in napake

Odgovor vsebuje code, message in data. Napaka lahko vsebuje reason in metadata. Strani v data vsebujejo items, total, page, page\_size in pages. Format posameznih metod je naveden v njihovem opisu.

Struktura odgovora s stranmi

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}
```

Žeton nadzorne plošče se preveri glede na rok veljavnosti in aktivnost uporabnika; če je omogočena vezava seje, še glede na IP in brskalnik. Kode TOKEN\_EXPIRED, TOKEN\_REVOKED, USER\_INACTIVE, INVALID\_TOKEN in FORBIDDEN razlikujejo težave s sejo in pravicami. Omejitev pogostosti in dodatna potrditev 2FA lahko preprečita posamezno zahtevo.

## [](https://ailoot.ai/docs/sl/cabinet/#kak-chitat-spravochnik)Kako brati referenčno dokumentacijo

- Vsak zapis vsebuje metodo HTTP, celotno pot, dostop, parametre, polja telesa in odgovor.
- Identifikatorje vzemite iz prejšnjega odgovora: KEY\_ID iz GET /api/v1/keys, ID zahteve iz GET /api/v1/usage.
- Polja objektov in njihove vrste so na straneh »Podatkovne sheme«.
- Predloge prikazujejo imena in vrste polj. PLACEHOLDER in TOKEN sta oznaki; pravih podatkov tukaj ni.
- Dodajanje sredstev je v razdelku »Cenik« nadzorne plošče: [kako dodati sredstva](https://ailoot.ai/docs/sl/billing/topup/).

## [](https://ailoot.ai/docs/sl/cabinet/#balans-i-frozen-balance)Stanje in frozen\_balance

Profil vsebuje balance in frozen\_balance. frozen\_balance je znesek, rezerviran za nedokončane zahteve. Obe polji preverite skupaj z zgodovino.

## [](https://ailoot.ai/docs/sl/cabinet/#klyuchi-i-limity)Ključi in omejitve

GET /api/v1/keys vrne vaše ključe. Polji `quota` in `quota_used` – omejitev porabe ključa in že porabljeni del; `ip_whitelist`, `ip_blacklist`, `status` in `expires_at` upravljajo uporabo ključa; `rate_limit_5h`, `rate_limit_1d` in `rate_limit_7d` – omejitve porabe v časovnih oknih.

Seznam in lastni ključ

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

# KEY_ID — id lastnega ključa iz odgovora s seznamom
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/sl/cabinet/#rashody-i-bezopasnost)Stroški in varnost

Zgodovina in nadzorna plošča prikazujeta actual\_cost – dejansko bremenitev; total\_cost – strošek po standardni ceni. Filtri po datumu, modelu, ključu in vrsti zahteve so navedeni pri metodi. Sprememba gesla, TOTP in ključi za dostop zahtevajo potrditve, opisane pri ustreznih metodah.

V tem razdelku: `39` metod.

Imate še vprašanja? Pošljite Request ID in opis – pomagali vam bomo razjasniti težavo.[Pišite podpori](mailto:support@ailoot.ai)

## Ailoot · Podjetje in njegov portfelj projektov





Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI.





Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.





Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.