Быстрый старт
API ключи
API ключ — это ваш персональный идентификатор для работы с ZvenoAI. Он связывает каждый запрос с вашим аккаунтом, балансом и статистикой.
Зачем нужен API ключ
API ключ нужен для любого взаимодействия с нейросетями через ZvenoAI: подключить кодингового агента (KiloCode, OpenCode, Cursor), интегрировать LLM в свой проект или собрать собственного бота. Ключ связывает каждый запрос с вашим аккаунтом и балансом, поэтому платформа знает, кому принадлежит вызов и откуда списывать токены.
Хотите сначала попробовать? Протестируйте любую модель прямо в браузере в чате ZvenoAI — без API ключа и без написания кода.
Аутентификация
Ключ подтверждает, что запрос отправлен именно вами. Без него API вернёт ошибку 401.
Привязка к балансу
Стоимость каждого запроса автоматически списывается с баланса аккаунта, к которому привязан ключ.
Аналитика и логирование
Все запросы группируются по ключам — вы видите расход токенов, стоимость и latency в разрезе каждого ключа.
Разделение окружений
Создайте отдельные ключи для продакшена, стейджинга и разработки, чтобы изолировать расходы и упростить ротацию.
Как это работает
Ключ передаётся в заголовке Authorization каждого HTTP-запроса. ZvenoAI проверяет его, определяет ваш аккаунт и маршрутизирует запрос к нужной модели.
Authorization: Bearer sk-...ваш_ключ
- Ваше приложение отправляет запрос с ключом в заголовке.
- ZvenoAI проверяет ключ и определяет аккаунт.
- Запрос маршрутизируется к выбранной модели (GPT, Claude, Gemini и др.).
- Ответ возвращается вашему приложению, а стоимость списывается с баланса.
Получение ключа
1. Зарегистрируйтесь или войдите
Создайте аккаунт, чтобы управлять биллингом и выпускать API ключи для доступа к ZvenoAI.
2. Получите API ключ
Перейдите в раздел API ключей, создайте новый ключ и сохраните его в безопасном месте — он понадобится для аутентификации запросов.
3. Отправьте первый запрос
Используйте любой OpenAI-совместимый SDK. Укажите базовый URL ZvenoAI и передайте ваш API ключ в заголовке Authorization.
Важно
Ключ показывается полностью только один раз — в момент создания. Если вы его потеряли, создайте новый и удалите старый.
Безопасность
API ключ даёт полный доступ к вашему балансу. Обращайтесь с ним как с паролем.
- Храните ключи в секрет-хранилищах (1Password, Vault, Doppler, AWS Secrets Manager).
- Никогда не коммитьте ключи в систему контроля версий — используйте переменные окружения.
- Используйте отдельные ключи для каждого окружения и сервиса.
- Ограничьте доступ к ключам только тем сотрудникам и сервисам, которым он необходим.
- Сразу удаляйте неиспользуемые ключи.
Ротация ключей
Периодическая замена ключей снижает риск при утечке. Рекомендуемая частота — каждые 30–90 дней для продакшн-окружений.
- Создайте новый API ключ в панели ZvenoAI.
- Обновите переменные окружения в вашем приложении.
- Убедитесь, что приложение работает с новым ключом.
- Удалите старый ключ из панели ZvenoAI.