Обзор HabAI API
Единый OpenAI-совместимый API к сотням моделей (ChatGPT, Claude, Gemini и другие) через один эндпоинт. Авторизация по API-ключу, биллинг по факту использования.
Быстрый старт
- Зарегистрируйтесь на сайте и войдите в личный кабинет.
- Создайте API-ключ в разделе «API-ключи» (формат
habai-…). - Отправьте запрос к
POST /v1/chat/completionsс заголовкомAuthorization: Bearer <КЛЮЧ>. - Пополните баланс — списание идёт автоматически за токены (тариф + наценка 10%).
curl https://habai.ek52.ru/v1/chat/completions \
-H "Authorization: Bearer habai-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "Привет!"}]
}'
Авторизация
Все платные запросы требуют API-ключ в заголовке Authorization: Bearer <ключ>. Получить ключ можно в кабинете или через API.
Регистрация
POST /auth/register
curl -X POST https://habai.ek52.ru/auth/register \
-H "Content-Type: application/json" \
-d '{"email":"you@x.com","password":"secret123"}'
Пароль минимум 6 символов. Сразу создаётся первый ключ и сессия.
Вход
POST /auth/login
curl -X POST https://habai.ek52.ru/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@x.com","password":"secret123"}'
Возвращает профиль и ставит cookie-сессию habai_session.
Создать API-ключ
POST /api/keys
curl -X POST https://habai.ek52.ru/api/keys \
-H "Authorization: Bearer habai-КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"name":"my-app"}'
Сырой ключ показывается один раз.
Ключи и баланс
GET /api/keys · /me
curl https://habai.ek52.ru/me \
-H "Authorization: Bearer habai-КЛЮЧ"
Удалить ключ: DELETE /api/keys/{id}.
Чат-комплишнс (OpenAI-совместимо)
Эндпоинт POST /v1/chat/completions совместим с форматом OpenAI: те же поля model, messages, stream. Можно использовать официальные SDK, подставив базовый URL и ключ.
import requests
API_KEY = "habai-ВАШ_КЛЮЧ"
URL = "https://habai.ek52.ru/v1/chat/completions"
resp = requests.post(
URL,
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"model": "gpt-4o-mini",
"messages": [
{"role": "system", "content": "Ты — полезный ассистент."},
{"role": "user", "content": "Напиши приветствие на русском."},
],
},
)
data = resp.json()
print(data["choices"][0]["message"]["content"])
print("Списано (руб):", data.get("habai", {}).get("cost_rub"))const API_KEY = "habai-ВАШ_КЛЮЧ";
const res = await fetch("https://habai.ek52.ru/v1/chat/completions", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Напиши приветствие." }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);curl https://habai.ek52.ru/v1/chat/completions \
-H "Authorization: Bearer habai-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"stream": true,
"messages": [{"role":"user","content":"Расскажи анекдот"}]
}'"stream": true — ответ вернётся в формате SSE (data: {…} … data: [DONE]). В поле habai ответа (не-stream) приходит расчёт токенов и стоимость в рублях.
Модели и цены
Полный каталог — на странице «Модели и цены». Через API список доступен двумя способами.
Публичный каталог
GET /api/models
curl "https://habai.ek52.ru/api/models?provider=openai&limit=10"Фильтры: q, provider, modality.
OpenAI-формат
GET /v1/models
curl https://habai.ek52.ru/v1/models \
-H "Authorization: Bearer habai-КЛЮЧ"Возвращает object: "list" с ценами за токен.
Веб-чат с историей
Для интерфейсов на сайте есть эндпоинты с сохранением истории и биллингом. Работают по сессии (cookie) или API-ключу.
Список чатов
GET /web/chats
curl https://habai.ek52.ru/web/chats \
-H "Authorization: Bearer habai-КЛЮЧ"Создать чат
POST /web/chats
curl -X POST https://habai.ek52.ru/web/chats \
-H "Authorization: Bearer habai-КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"title":"Поддержка","model":"gpt-4o-mini"}'Отправить сообщение
POST /web/chat/send
curl -X POST https://habai.ek52.ru/web/chat/send \
-H "Authorization: Bearer habai-КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"chat_id":1,"message":"Привет!"}'Пополнение баланса
POST /api/deposit
curl -X POST https://habai.ek52.ru/api/deposit \
-H "Authorization: Bearer habai-КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"amount":500}'Коды ответов и ошибки
| Код | Значение | Что делать |
|---|---|---|
| 401 | Неверный/пустой ключ | Передайте валидный Authorization: Bearer … |
| 402 | Недостаточно баланса | Пополните счёт в кабинете |
| 404 | Модель не найдена | Проверьте model через /api/models |
| 400 | Некорректный запрос | Проверьте тело (поле model обязательно) |
| 502 | Ошибка вышестоящего API | Повторите позже |
Готовы начать?
Зарегистрируйтесь, создайте ключ и сделайте первый запрос к нейросети.
Создать аккаунт