Добро пожаловать в справочник Gonka SaaS API. Этот раздел документирует все доступные эндпоинты, форматы запросов/ответов и шаблоны использования.
Базовый URL
Все API запросы должны отправляться на:
https://api.aigonka.ru
Аутентификация
Большинство API эндпоинтов требуют аутентификации с использованием API ключа:
curl https://api.aigonka.ru/v1/chat/completions \
-H "Authorization: Bearer gk-ваш_API_ключ..."
Для endpoints dashboard и управления ключами используйте JWT токены:
curl https://api.aigonka.ru/api/keys \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
AI API (v1)
| Метод | Эндпоинт | Описание | Аутентификация |
|---|
| POST | /v1/chat/completions | Завершение чата | API ключ |
| GET | /v1/models | Список доступных моделей | Нет |
Аутентификация
| Метод | Эндпоинт | Описание | Аутентификация |
|---|
| POST | /api/auth/register | Регистрация нового пользователя | Нет |
| POST | /api/auth/login | Вход и получение JWT | Нет |
| GET | /api/auth/me | Получить текущего пользователя | JWT |
API ключи
| Метод | Эндпоинт | Описание | Аутентификация |
|---|
| GET | /api/keys | Список API ключей | JWT |
| POST | /api/keys | Создать API ключ | JWT |
| DELETE | /api/keys/:id | Отозвать API ключ | JWT |
Использование и биллинг
| Метод | Эндпоинт | Описание | Аутентификация |
|---|
| GET | /api/usage | Статистика использования | JWT |
| GET | /api/balance | Текущий баланс | JWT |
Проверка состояния
| Метод | Эндпоинт | Описание | Аутентификация |
|---|
| GET | /health | Состояние сервиса | Нет |
| GET | /health/upstream | Состояние upstream | Нет |
| GET | /health/ready | Проверка готовности | Нет |
Формат запроса
Заголовки
Authorization: Bearer <api-ключ-или-jwt>
Content-Type: application/json
Тело запроса
Все тела запросов в формате JSON:
{
"model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
"messages": [
{
"role": "user",
"content": "Привет!"
}
]
}
Формат ответа
Успешный ответ
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1705312200,
"model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
"choices": [...],
"usage": {
"prompt_tokens": 13,
"completion_tokens": 9,
"total_tokens": 22
}
}
Ответ с ошибкой
{
"error": {
"message": "Описание ошибки",
"type": "тип_ошибки"
}
}
Ограничения запросов
| Эндпоинт | Лимит |
|---|
| API ключ (чат) | 60 запросов/минуту |
| Эндпоинты аутентификации | 10 запросов/минуту |
| Общий API | 100 запросов/минуту |