API-ключи

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

1. Нажмите «Новый»

   В разделе Панель управления → API ключи.

2. Настройте ключ

   Имя и, если нужно, бюджет, модели, IP, срок и защита данных. Панель «Что пройдёт с этим ключом» сразу показывает, какие запросы ключ пропустит, а какие API отклонит и с каким кодом.

3. Скопируйте ключ и первый запрос

   После «Создать ключ» откроется ключ формата sk-aitunnel-xxx и готовый запрос на cURL, Python, Node.js и для Claude Code — копируется уже с ключом. «Проверить ключ» делает бесплатный запрос к GET /aitunnel/key с вашего устройства. Ключ можно снова показать и скопировать в панели в любой момент.

Формат ключа

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

Authorization: Bearer sk-aitunnel-xxx

Ключ принимается и в заголовке x-api-key — так его отправляют SDK и инструменты Anthropic. Если в запросе есть оба заголовка, берётся Authorization.

Как хранится ключ

AITUNNEL не хранит ключ в открытом виде. В базе лежат его SHA-256-хеш — по нему API узнаёт ключ — и зашифрованная копия, которую может расшифровать только API-шлюз. Поэтому в списке ключей виден только конец ключа (sk-aitunnel-••••x7Qa), а полный ключ панель запрашивает у API, когда вы нажимаете «скопировать», «показать» или «Проверить ключ». Каждый такой показ записывается в Настройки → Безопасность. Администратор, вошедший в ваш аккаунт для поддержки, ключи не видит.

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

Сколько ключей можно создать, зависит от текущего баланса. При балансе 0 ₽ — ни одного. Как только на счёте есть деньги — один ключ. Дальше каждый полный 1 000 ₽ даёт ещё один.

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

Имя ключа

Имя нужно только вам, на запросы оно не влияет. Удобно называть по назначению: Production API, Dev / Testing, Claude Code.

Информация о ключе

Текущие настройки ключа через API — GET /aitunnel/key.

Бюджет ключа

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

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

• Сумма — максимум расходов в рублях
• Интервал сброса (необязательно) — daily, weekly или monthly

Бюджет считается как лимит минус потраченное за текущий период: budget.remaining = budget.initial − budget.spent в GET /aitunnel/key. Сброс обнуляет потраченное. Если поменять лимит, потраченное сохраняется: подняли лимит с 1 000 до 2 000 ₽ при расходе 800 ₽ — осталось 1 200 ₽. Поле «Осталось сейчас» в настройках можно поправить вручную, не меняя лимит. Стоимость запроса известна после ответа, поэтому последний запрос может немного выйти за лимит; остаток при этом показывается как 0, а следующие запросы получают 402 с типом budget_exceeded. Если бюджета хватает на вход запроса, но не на весь ответ, вывод ограничивается остатком бюджета — в ответе приходит заголовок X-AITunnel-Output-Capped (см. лимит расходов).

Можно включить письмо, когда останется меньше 20% бюджета — на почту аккаунта или на другой адрес.

Срок действия

Срок задаётся в настройках ключа, там же его можно продлить или снять. Над выбором всегда видно, до какой даты и времени будет работать ключ и сколько осталось:

• 1 час / 1 день / 7 / 30 / 90 дней — отсчёт с момента сохранения
• Точная дата и время — в календаре, не дальше чем через 5 лет
• Без срока — ключ бессрочный

По истечении срока запросы отклоняются с 401, но ключ не удаляется: он лежит в свёрнутой группе «Истёкшие» внизу списка, и его можно продлить в настройках — секрет, бюджет и настройки останутся прежними.

Разрешённые модели

Можно ограничить, какие модели вызывает ключ. В настройках ключа переключите «Доступ к моделям» с «Все модели» на «Только из списка» и найдите модель поиском или выберите из каталога, сгруппированного по провайдерам, — можно добавить сразу все модели провайдера. Подходят каталожные имена, слаги OpenRouter (openai/gpt-5), auto и имена пресетов. Пустой список — все модели. Длинный список удобно вставить через запятую или с новой строки, либо нажать «Списком текста» под списком.

Совпадение точное, с учётом регистра: gpt-5 и openai/gpt-5 — разные записи. Если модели нет в списке, API отвечает 403. Имена, которых нет ни в каталоге, ни среди пресетов, панель подсвечивает и предлагает исправление.

Разрешённые IP

Ключ можно привязать к адресам или CIDR-диапазонам (IPv4 и IPv6). Пусто — запросы с любого IP. Иначе чужой адрес получит 403. В настройках ключа кнопка «Добавить мой IP» подставляет адрес, с которого вы сейчас открыли панель; для сервера или другой сети впишите его вручную.

Пауза

Ключ можно временно отключить, не удаляя: меню «•••» у ключа → «Поставить на паузу». Пока ключ на паузе, API отвечает 403 с сообщением «Этот API-ключ приостановлен владельцем». Секрет, бюджет и настройки сохраняются, «Возобновить» включает ключ обратно сразу.

Ключ, с которым 90 дней не было запросов к моделям, ставится на паузу автоматически — так забытый ключ не сможет использовать тот, к кому он попал. Тогда API отвечает 403 «Этот API-ключ приостановлен, потому что с ним не было запросов 90 дней», а в Настройки → Безопасность появляется запись об этом. Отсчёт идёт от последнего запроса, а если запросов не было — от создания ключа, последнего «Возобновить» или сброса секрета. Включается ключ так же: «Возобновить», код менять не нужно.

Защита данных

На ключе можно включить поиск персональных данных в запросах: паспорта, ИНН, телефоны, ФИО. Два режима — подменить синтетикой до модели или сразу вернуть ошибку. Подробности — в статье Защита данных (PII).

Управление

В списке ключей у выбранного ключа видно остаток бюджета, сколько потрачено, последний вызов, что ему разрешено, и ссылки на активность и live-логи только по этому ключу. «Изменить» открывает настройки: имя, бюджет и остаток, модели, IP, срок и защита данных. В меню «•••» — «Дублировать», «Скопировать настройки», «Поставить на паузу», «Сбросить секрет» и «Удалить». Список можно отсортировать по созданию, последнему вызову, расходу или имени, а счётчик «N из M ключей» показывает лимит по балансу. Удалённый ключ сразу перестаёт работать: запросы возвращают 401 с сообщением «Этот API-ключ удалён». Восстановить его нельзя, но статистика и логи его запросов остаются под его именем.

Ключ можно сбросить: секрет меняется на новый, а имя, бюджет, остаток, расходы, срок, модели, IP и защита данных остаются. Старый секрет перестаёт работать сразу; в заголовке ключа вместо даты создания показана дата последнего сброса. После сброса и после дублирования панель сразу показывает новый ключ и готовый код с ним.

«Скопировать настройки» переносит настройки выбранного ключа на другие ваши ключи. В окне отмечаете, что копировать — бюджет (лимит, автосброс и письмо), модели и пресеты, IP-адреса, защита данных, — и на какие ключи; у каждого ключа видно, что у него изменится. Секрет, срок, пауза и расходы не копируются: потраченное за период у каждого ключа своё, а остаток считается от нового лимита.

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

1. Разделяйте ключи по назначению — продакшен, разработка, тесты
2. Ставьте бюджеты — особенно на тестовые и общие ключи
3. Сбрасывайте секрет, если ключ мог утечь — настройки и бюджет сохраняются
4. Ограничивайте модели и IP — особенно на ключах, которые раздаёте команде или встраиваете в клиент
5. Не коммитьте ключи — только переменные окружения, не код и не git
6. Смотрите расходы в статистике