docs
Жеке кабинет API-і

Жеке кабинет API-і

Markdown

Жеке кабинет әдістері: кіру, профиль, кілттер және шығындар тарихы.

Толық нұсқаулық

Мекенжайлар және авторизация

  • Жеке кабинет: https://ailoot.ai (логинмен кіру, жеке кабинет токені)
  • Модельдер API-і: https://api.ailoot.ai (sk-… кілті)
НеМекенжайАвторизация
Жеке кабинет API-іhttps://ailoot.ai/api/v1Authorization: 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 әдіс.

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.Қолдау қызметіне жазу