Fiók-API

• Fiók: https://ailoot.ai (bejelentkezés, fióktoken)
• Modell-API: https://api.ailoot.ai (sk-… kulcs)

Kulcs sk-… nem helyettesíti a fióktokent, a fióktoken pedig nem biztosít hozzáférést a modell-API-hoz. A teljes útvonal minden metódusnál szerepel.

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

A válasz code, message és data mezőt tartalmaz. Hiba esetén reason és metadata is szerepelhet. A data lapozási adatai: items, total, page, page_size és pages. Az egyes metódusok formátumát a leírásuk tartalmazza.

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

A fióktokennél ellenőrizzük az érvényességi időt és a felhasználó aktív állapotát; bekapcsolt munkamenet-kötés esetén az IP-címet és a böngészőt is. A TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN és FORBIDDEN kódok megkülönböztetik a munkamenet- és jogosultsági problémákat. A gyakorisági korlát és a további 2FA-megerősítés egy adott kérést megakadályozhat.

• Minden bejegyzés tartalmazza a HTTP-metódust, a teljes útvonalat, a hozzáférést, a paramétereket, a törzs mezőit és a választ.
• Az azonosítókat a korábbi válaszból vegye: KEY_ID a GET /api/v1/keys, a kérés azonosítója a GET /api/v1/usage válaszából származik.
• Az objektumok mezői és típusai az „Adatsémák” oldalain találhatók.
• A sablonok a mezők nevét és típusát mutatják. A PLACEHOLDER és TOKEN jelölők; valódi adatok itt nincsenek.
• Az egyenlegfeltöltés a fiók „Díjcsomagok” részében érhető el: az egyenleg feltöltése.

A profil balance és frozen_balance mezőt tartalmaz. A frozen_balance a befejezetlen kérésekhez zárolt összeg. Mindkét mezőt az előzményekkel együtt ellenőrizze.

A GET /api/v1/keys az Ön kulcsait adja vissza. A quota és quota_used mező a kulcs költési korlátja és annak már elköltött része; ip_whitelist, ip_blacklist, status és expires_at a kulcs használatát szabályozzák; rate_limit_5h, rate_limit_1d és rate_limit_7d — az időablakokra vonatkozó költési korlátok.

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

# KEY_ID — a saját kulcs id értéke a listázás válaszából
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Az előzmények és a dashboard megjelenítik az actual_cost értéket — a tényleges terhelést; a total_cost a normál áron számított költség. A dátum-, modell-, kulcs- és kéréstípusszűrők a metódusnál szerepelnek. A jelszóváltáshoz, a TOTP-hez és a passkeyhez az adott metódusoknál leírt megerősítések szükségesek.

Ebben a részben: 39 metódus.