Документация API

API совместим с OpenAI: меняете адрес и ключ — остальной код работает как раньше.

Адрес: https://aika.by/api/v1
Ключ: aika_… (выпускается в кабинете)

Список моделей

curl https://aika.by/api/v1/models -H "Authorization: Bearer aika_ВАШ_КЛЮЧ"

Запрос к модели

curl https://aika.by/api/v1/chat/completions \ -H "Authorization: Bearer aika_ВАШ_КЛЮЧ" -H "Content-Type: application/json" \ -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"Привет!"}]}'

Python (OpenAI SDK)

from openai import OpenAI c = OpenAI(base_url="https://aika.by/api/v1", api_key="aika_ВАШ_КЛЮЧ") r = c.chat.completions.create(model="deepseek-v4.1-flash", messages=[{"role":"user","content":"Привет!"}]) print(r.choices[0].message.content)

Поток (streaming)

Параметр "stream": true отдаёт Server-Sent Events, как у OpenAI. Расход считается по последнему чанку.

Параметры запроса

Поле	Что делает
max_tokens	предел длины ответа. Для моделей с размышлениями ставьте не меньше 1500, иначе весь лимит уйдёт в размышления и ответ придёт пустым.
reasoning	{"enabled":true,"effort":"low"} — размышления модели. Уровни: minimal, low, medium, high. Наружу рассуждения не отдаются; если нужны — добавьте "exclude":false.
plugins	[{"id":"web"}] — поиск в интернете. Работает с "stream": true: обычный ответ со поиском может не уложиться в таймаут шлюза.
messages	история диалога, как у OpenAI. Системный промпт — сообщением с "role":"system".

Тот же набор параметров доступен в чате кабинета: кнопка ⚙ Параметры (макс. токены, размышления и уровень, системный промпт, кеширование промпта, поиск в интернете). Настройки сохраняются в теме.

Если ваш сервер или библиотека теряет заголовок Authorization, ключ можно передать заголовком X-Api-Key.

Коды ошибок

Код	Что значит	Что делать
401	ключа нет или он отозван	выпустить новый в кабинете
402	нулевой или отрицательный баланс, либо исчерпан месячный лимит ключа	попросить счёт и пополнить или поднять лимит ключа
403	ключу закрыта эта модель, истёк срок действия или запрос с чужого IP	выпустить ключ с нужными правами в кабинете
429	превышен лимит запросов	снизить частоту или написать нам
502	вышестоящая модель не ответила	повторить запрос

Зарегистрироваться