dokumentacja
API panelu użytkownika

API panelu użytkownika

Markdown

Metody panelu użytkownika: logowanie, profil, klucze i historia wydatków.

Pełny przewodnik

Adresy i autoryzacja

  • Panel użytkownika: https://ailoot.ai (logowanie przy użyciu loginu, token panelu użytkownika)
  • API modeli: https://api.ailoot.ai (klucz sk-…)
CoAdresAutoryzacja
API panelu użytkownikahttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — token panelu użytkownika po zalogowaniu
API modelihttps://api.ailoot.ai/v1Klucz sk-… z sekcji „Klucze API”; zobacz Klucze i adres API

Klucz sk-… nie zastępuje tokena panelu użytkownika, a token panelu użytkownika nie otwiera API modeli. Pełną ścieżkę podano przy każdej metodzie.

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

Format odpowiedzi i błędy

Odpowiedź zawiera code, message i data. W błędzie mogą występować reason i metadata. Paginacja w data zawiera items, total, page, page_size i pages. Format poszczególnych metod podano w ich opisie.

Struktura odpowiedzi z paginacją
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

Token panelu użytkownika jest sprawdzany pod względem terminu ważności oraz tego, czy użytkownik jest aktywny; jeśli włączono powiązanie sesji, także według IP i przeglądarki. Kody TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN i FORBIDDEN rozróżniają problemy sesji i uprawnień. Limit częstotliwości i dodatkowe potwierdzenie 2FA mogą zablokować pojedyncze żądanie.

Jak korzystać z dokumentacji

  • Każdy wpis zawiera metodę HTTP, pełną ścieżkę, dostęp, parametry, pola treści i odpowiedź.
  • Identyfikatory bierz z poprzedniej odpowiedzi: KEY_ID — z GET /api/v1/keys, ID żądania — z GET /api/v1/usage.
  • Pola obiektów i ich typy — na stronach „Schematy danych”.
  • Szablony pokazują nazwy i typy pól. PLACEHOLDER i TOKEN to znaczniki, nie ma tu rzeczywistych danych.
  • Doładowanie salda — w sekcji „Cennik” panelu użytkownika: jak doładować.

Saldo i frozen_balance

Profil zawiera balance i frozen_balance. frozen_balance to kwota zarezerwowana na niezakończone żądania. Sprawdzaj oba pola razem z historią.

Klucze i limity

GET /api/v1/keys zwraca Twoje klucze. Pola quota i quota_used — limit wydatków klucza i już wykorzystana część; ip_whitelist, ip_blacklist, status i expires_at sterują użyciem klucza; rate_limit_5h, rate_limit_1d i rate_limit_7d — limity wydatków w oknach czasowych.

Lista i własny klucz
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — id własnego klucza z odpowiedzi zawierającej listę
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Wydatki i bezpieczeństwo

Historia i dashboard pokazują actual_cost — faktyczne obciążenie; total_cost — koszt według standardowej ceny. Filtry daty, modelu, klucza i typu żądania podano przy metodzie. Zmiany hasła, TOTP i kluczy dostępu (passkey) wymagają potwierdzeń opisanych przy odpowiednich metodach.

W tej sekcji: 39 metod.

Dodatkowe pytania? Prześlij Request ID i opis — pomożemy wyjaśnić sprawę.Napisz do wsparcia