Это практическое руководство поможет разработчикам интегрировать AI модели в свои приложения через API AIAI.BY. Мы пройдём весь путь от получения ключа до production-ready интеграции.
Шаг 1: Регистрация и получение API-ключа
Зарегистрируйтесь на aiai.by и получите API-ключ в личном кабинете. Ключ имеет формат Bearer-токена и используется для аутентификации всех запросов.
Важно: никогда не храните API-ключ в исходном коде. Используйте переменные окружения или менеджеры секретов.
Шаг 2: Базовый запрос
API AIAI.BY совместим с форматом OpenAI. Базовый URL: https://vedai.by/api/v1. Для отправки запроса используйте endpoint /chat/completions с вашей моделью. Поддерживаются все параметры OpenAI API: temperature, max_tokens, top_p, frequency_penalty и другие.
Для Python используйте библиотеку openai, просто замените base_url на https://vedai.by/api/v1 и укажите ваш API-ключ. Для JavaScript/TypeScript — аналогично с пакетом openai.
Шаг 3: Выбор модели
Через AIAI.BY доступны 50+ моделей. Для текстовых задач: gpt-5, claude-sonnet-4.5, gemini-3-pro, deepseek-v3.2. Для изображений: dall-e-3-hd, flux-dev. Для эмбеддингов: text-embedding-3-large.
Начните с GPT-4o-mini для тестирования (самый дешёвый), затем переходите на более мощные модели для production.
Шаг 4: Streaming ответов
Для улучшения UX используйте streaming — модель начинает отправлять ответ по частям сразу, не дожидаясь полной генерации. Это критически важно для чат-интерфейсов.
Установите параметр stream: true в запросе. Ответ будет приходить в формате Server-Sent Events (SSE). Большинство SDK обрабатывают streaming автоматически.
Шаг 5: Обработка ошибок
Основные ошибки API: 401 (неверный ключ), 429 (превышение лимитов), 500 (ошибка сервера). Реализуйте exponential backoff для повторных попыток при 429 и 500 ошибках.
Установите разумные таймауты (30-60 секунд для стандартных запросов, до 120 секунд для длинных генераций). Логируйте все ошибки для мониторинга.
Шаг 6: Оптимизация стоимости
Основные способы снизить затраты: используйте лёгкие модели для простых задач, кэшируйте повторяющиеся запросы, оптимизируйте промпты (меньше токенов = меньше стоимость), используйте batch API для массовых операций.
Мониторьте расходы через личный кабинет AIAI.BY. Установите лимиты бюджета, чтобы избежать непредвиденных расходов.
Production checklist
Перед запуском в production проверьте: API-ключ хранится в безопасном месте, реализована обработка ошибок и retry-логика, установлены таймауты и rate limiting, настроен мониторинг и алертинг, есть fallback на альтернативную модель, протестирована нагрузка.