Жеке кабинет API-і
MarkdownЖеке кабинет әдістері: кіру, профиль, кілттер және шығындар тарихы.
Толық нұсқаулық
Мекенжайлар және авторизация
- Жеке кабинет: https://ailoot.ai (логинмен кіру, жеке кабинет токені)
- Модельдер API-і: https://api.ailoot.ai (sk-… кілті)
| Не | Мекенжай | Авторизация |
|---|---|---|
| Жеке кабинет API-і | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — кіргеннен кейінгі жеке кабинет токені |
| Модельдер API-і | https://api.ailoot.ai/v1 | Кілт sk-… «API кілттері» бөлімінен; қараңыз: Кілттер және API мекенжайы |
Кілт sk-… жеке кабинет токенін алмастырмайды, ал жеке кабинет токені модельдер API-іне қол жеткізуді ашпайды. Толық жол әр әдісте көрсетілген.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"Жауап форматы және қателер
Жауапта code, message және data бар. Қатеде reason және metadata болуы мүмкін. data ішіндегі беттеуде items, total, page, page_size және pages бар. Жеке әдістердің форматы олардың сипаттамаларында көрсетілген.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}Жеке кабинет токенінің жарамдылық мерзімі мен пайдаланушының белсенділігі тексеріледі; сеансқа байлау қосылса, IP мен браузер де тексеріледі. TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN және FORBIDDEN кодтары сеанс пен құқықтар мәселелерін ажыратады. Жиілік лимиті мен қосымша 2FA растауы жеке сұрауға тыйым салуы мүмкін.
Анықтамалықты қалай оқу керек
- Әр жазбада HTTP әдісі, толық жол, қол жеткізу, параметрлер, дене өрістері және жауап бар.
- Идентификаторларды алдыңғы жауаптан алыңыз: KEY_ID — GET /api/v1/keys жауабынан, сұрау ID-і — GET /api/v1/usage жауабынан.
- Нысан өрістері мен олардың түрлері «Деректер схемалары» беттерінде берілген.
- Үлгілер өріс атаулары мен түрлерін көрсетеді. PLACEHOLDER және TOKEN — маркерлер, мұнда нақты деректер жоқ.
- Балансты толықтыру — жеке кабинеттің «Тарифтер» бөлімінде: қалай толықтыруға болады.
Баланс және frozen_balance
Профильде balance және frozen_balance бар. frozen_balance — аяқталмаған сұрауларға резервтелген сома. Екі өрісті де тарихпен бірге тексеріңіз.
Кілттер және лимиттер
GET /api/v1/keys кілттеріңізді қайтарады. Мына өрістер: quota және quota_used — кілттің шығын лимиті және жұмсалған бөлігі; ip_whitelist, ip_blacklist, status және expires_at кілттің қолданылуын басқарады; rate_limit_5h, rate_limit_1d және rate_limit_7d — уақыт аралықтарындағы шығын лимиттері.
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
-H "Authorization: Bearer $TOKEN"
# KEY_ID — тізім жауабындағы өз кілтіңіздің id мәні
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
-H "Authorization: Bearer $TOKEN"Шығындар және қауіпсіздік
Тарих пен dashboard ішінде actual_cost — нақты есептен шығару; total_cost — стандартты бағамен құны көрсетіледі. Күн, модель, кілт және сұрау түрі бойынша сүзгілер әдісте көрсетілген. Құпиясөзді, TOTP мен passkey өзгерту үшін тиісті әдістерде сипатталған растаулар қажет.
Бұл бөлімде: 39 әдіс.