Аутентификация

Все запросы к API требуют аутентификации через API-ключ, передаваемый в заголовке Authorization.

Формат API-ключа

API-ключи имеют формат:

sk_live_<32 случайных символа>

Пример: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345

Использование API-ключа

Передавайте ключ как Bearer-токен в заголовке Authorization:

curl https://api.genvoice.ru/v1/api/balance \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Создание API-ключа

1. Войдите в app.genvoice.ru
2. Перейдите в Настройки → API-ключи
3. Нажмите Создать API-ключ
4. Скопируйте ключ сразу — он показывается только один раз

Внимание

Храните API-ключ в безопасном месте. Он даёт полный доступ к балансу и голосам вашего аккаунта. При компрометации немедленно отзовите ключ через панель управления.

Управление ключами

• Максимум 10 активных ключей на аккаунт
• Ключи можно отозвать (деактивировать) в любой момент
• Отзыв ключа необратим и вступает в силу мгновенно
• Для каждого ключа отображается время последнего использования

Рекомендации по безопасности

• Никогда не коммитьте API-ключи в репозиторий
• Храните ключи в переменных окружения
• Периодически ротируйте ключи
• Используйте отдельные ключи для разных приложений

import os

api_key = os.environ["GENVOICE_API_KEY"]