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

API ключ — это ваш идентификатор для доступа к AITUNNEL API. Один ключ работает со всеми моделями и эндпоинтами.

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

1. Перейдите в Панель управления → Ключи
2. Нажмите «Создать ключ»
3. Скопируйте сгенерированный ключ (формат sk-aitunnel-xxx)

Сохраните ключ

Ключ показывается только один раз при создании. Если вы его потеряли — создайте новый.

Формат ключа

Все ключи AITUNNEL начинаются с префикса sk-aitunnel-. Используйте ключ в заголовке Authorization:

Authorization: Bearer sk-aitunnel-xxx

Лимит на количество ключей

Количество ключей зависит от текущего баланса аккаунта, а не от суммарных пополнений.

• Создавать ключи можно только если баланс > 0 ₽
• Максимальное количество ключей зависит от суммы на балансе

Если у вас уже создано больше ключей, чем позволяет текущий баланс, они продолжают работать, но создать новый ключ нельзя, пока вы не пополните баланс до следующего порога. В ошибке при создании ключа будет указано, сколько рублей нужно доплатить до следующего лимита.

Имя ключа

Каждому ключу можно задать понятное имя для удобной навигации:

• Production API — для боевых сервисов
• Dev / Testing — для разработки
• Claude Code — для конкретного инструмента

Имя ключа доступно через эндпоинт /v1/aitunnel/key.

Бюджет ключа

Бюджет ограничивает максимальную сумму расходов по конкретному ключу. Когда бюджет исчерпан, запросы с этим ключом будут отклонены с ошибкой, даже если на балансе аккаунта есть средства.

Настройка бюджета

При создании или редактировании ключа укажите:

• Сумма бюджета — максимальные расходы в рублях
• Интервал сброса (опционально) — автоматический сброс бюджета: daily (ежедневно), weekly (еженедельно) или monthly (ежемесячно)

Проверка бюджета через API

Информация о бюджете доступна через эндпоинт /v1/aitunnel/key:

{
  "name": "Production API",
  "budget": {
    "remaining": 850.5,
    "initial": 1000.0,
    "reset_interval": "monthly",
    "reset_at": "2026-03-15T12:00:00.000Z",
    "reset_in_seconds": 1728000
  }
}

Поле	Описание
budget.remaining	Оставшийся бюджет ключа в рублях
budget.initial	Начальный бюджет (сумма при создании/последнем сбросе)
budget.reset_interval	Интервал сброса: daily, weekly, monthly
budget.reset_at	Дата и время следующего сброса (ISO 8601)
budget.reset_in_seconds	Секунд до следующего сброса

Объект budget присутствует только если бюджет настроен для ключа.

Срок действия ключа

При создании ключа можно задать срок действия:

• 15 минут — для одноразовых задач
• 1 час — для коротких сессий
• 24 часа — для дневных задач
• 7 дней — для недельных проектов
• 30 дней — для месячных проектов
• 90 дней — для долгосрочных проектов
• Без ограничения — ключ действует бессрочно

По истечении срока действия ключ перестаёт работать. Создайте новый ключ при необходимости.

Проверка срока через API

Информация об истечении ключа доступна в ответе /v1/aitunnel/key:

{
  "name": "Temp key",
  "expires_at": "2026-03-24T15:30:00.000Z",
  "expires_in_seconds": 86400
}

Поле	Описание
expires_at	Дата и время истечения ключа (ISO 8601)
expires_in_seconds	Секунд до истечения ключа

Поля истечения присутствуют только если у ключа задан срок действия.

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

Редактирование

Вы можете изменить имя и бюджет существующего ключа в панели управления.

Удаление

Удалённый ключ немедленно перестаёт работать. Все запросы с удалённым ключом будут возвращать ошибку 401.

Лучшие практики

1. Разделяйте ключи по назначению: отдельный ключ для продакшена, разработки, тестирования
2. Используйте бюджеты: особенно для тестовых и общих ключей
3. Ротация ключей: периодически создавайте новые ключи и удаляйте старые
4. Не коммитьте ключи: храните ключи в переменных окружения, не в коде
5. Мониторинг: проверяйте расходы по ключам в статистике