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

[Hallintapaneelin API](https://ailoot.ai/docs/fi/) 

# Hallintapaneelin API

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

Henkilökohtaisen hallintapaneelin metodit: kirjautuminen, profiili, avaimet ja kulutushistoria.

Tämä on ailoot.ai-palvelun henkilökohtaisen hallintapaneelin API: kirjautuminen, profiili, avaimet ja kulutushistoria. Mallipyynnöt lähetetään toiseen osoitteeseen — `https://api.ailoot.ai` avaimella `sk-…`. Metodien käyttöoikeus riippuu tilisi oikeuksista ja käytössä olevista toiminnoista.

## [](https://ailoot.ai/docs/fi/cabinet/#adresa-i-avtorizatsiya)Osoitteet ja todennus

- Hallintapaneeli: https://ailoot.ai (kirjautuminen tunnuksella, hallintapaneelin token)
- Mallien API: https://api.ailoot.ai (avain sk-…)

| Asia | Osoite | Todennus |
| --- | --- | --- |
| Hallintapaneelin API | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — hallintapaneelin token kirjautumisen jälkeen |
| Mallien API | `https://api.ailoot.ai/v1` | Avain `sk-…` ”API-avaimet”-osiosta; katso [Avaimet ja API-osoite](https://ailoot.ai/docs/fi/keys/) |

Avain `sk-…` ei korvaa hallintapaneelin tokenia, eikä hallintapaneelin token avaa mallien APIa. Kunkin metodin koko polku ilmoitetaan sen kohdalla.

Oman profiilin lukeminen

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

## [](https://ailoot.ai/docs/fi/cabinet/#format-otveta-i-oshibki)Vastauksen muoto ja virheet

Vastaus sisältää code-, message- ja data-kentät. Virheessä voivat esiintyä reason ja metadata. Sivutus data-kentässä sisältää items-, total-, page-, page\_size- ja pages-kentät. Kunkin metodin muoto ilmoitetaan sen kuvauksessa.

Sivutetun vastauksen rakenne

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

Hallintapaneelin tokenista tarkistetaan voimassaoloaika ja käyttäjän aktiivisuus; jos istunnon sitominen on käytössä, myös IP ja selain. Koodit TOKEN\_EXPIRED, TOKEN\_REVOKED, USER\_INACTIVE, INVALID\_TOKEN ja FORBIDDEN erottavat istunto- ja käyttöoikeusongelmat. Pyyntötiheyden raja ja ylimääräinen 2FA-vahvistus voivat estää yksittäisen pyynnön.

## [](https://ailoot.ai/docs/fi/cabinet/#kak-chitat-spravochnik)Näin luet API-opasta

- Jokainen merkintä sisältää HTTP-metodin, koko polun, käyttöoikeuden, parametrit, rungon kentät ja vastauksen.
- Ota tunnisteet aiemmasta vastauksesta: KEY\_ID metodista GET /api/v1/keys, pyynnön ID metodista GET /api/v1/usage.
- Objektien kentät ja niiden tyypit löytyvät ”Tietoskeemat”-sivuilta.
- Mallipohjat näyttävät kenttien nimet ja tyypit. PLACEHOLDER ja TOKEN ovat merkkejä; tässä ei ole oikeita tietoja.
- Saldon lataaminen on hallintapaneelin ”Hinnoittelu”-osiossa: [näin lataat saldoa](https://ailoot.ai/docs/fi/billing/topup/).

## [](https://ailoot.ai/docs/fi/cabinet/#balans-i-frozen-balance)Saldo ja frozen\_balance

Profiili sisältää balance- ja frozen\_balance-kentät. frozen\_balance on keskeneräisille pyynnöille varattu summa. Tarkista molemmat kentät yhdessä historian kanssa.

## [](https://ailoot.ai/docs/fi/cabinet/#klyuchi-i-limity)Avaimet ja rajoitukset

GET /api/v1/keys palauttaa omat avaimesi. Kentät `quota` ja `quota_used` — avaimen kulutusraja ja jo käytetty osuus; `ip_whitelist`, `ip_blacklist`, `status` ja `expires_at` ohjaavat avaimen käyttöä; `rate_limit_5h`, `rate_limit_1d` ja `rate_limit_7d` — jaksojen kulutusrajat.

Luettelo ja oma avain

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

# KEY_ID — oman avaimesi id listavastauksesta
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/fi/cabinet/#rashody-i-bezopasnost)Kulutus ja turvallisuus

Historia ja yleisnäkymä näyttävät actual\_cost-arvon — toteutuneen veloituksen; total\_cost on vakiohinnan mukainen hinta. Päivämäärä-, malli-, avain- ja pyyntötyyppisuodattimet ilmoitetaan metodin kohdalla. Salasanan, TOTP:n ja pääsyavaimen muutokset vaativat kyseisten metodien kohdalla kuvatut vahvistukset.

Tässä osiossa: `39` metodia.

Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.[Ota yhteyttä tukeen](mailto:support@ailoot.ai)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.