API panelu użytkownika
MarkdownMetody 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-…)
| Co | Adres | Autoryzacja |
|---|---|---|
| API panelu użytkownika | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — token panelu użytkownika po zalogowaniu |
| API modeli | https://api.ailoot.ai/v1 | Klucz 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.
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.
{
"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.
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.