--- title: "Создание и защита ключей API" description: "Где создать ключ, как ограничить доступ и что делать при утечке." --- Создайте ключ в разделе [ключей API](https://1zheai.com/keys?lng=ru) кабинета. Укажите понятное имя и доступные ограничения модели и расхода. Для каждого приложения лучше использовать отдельный ключ, чтобы его можно было отозвать независимо. ## Хранение и использование Копируйте полный ключ в секретное поле приложения или переменную окружения. Не встраивайте ключ в браузерный JavaScript, мобильный клиент, общедоступный workflow или репозиторий. Для сайта вызывайте API со своего сервера; пользовательский браузер должен обращаться к вашему серверу. Кнопки импорта и копирования настроек могут содержать полный ключ, даже если предварительный просмотр маскирует его. Проверяйте целевой клиент и не пересылайте такие ссылки. ## Если доступ не работает При 401 проверьте наличие ключа в новом процессе, отсутствие лишних пробелов и правильный заголовок. При 403 или недоступной модели проверьте права, ограничения и баланс. Успешный вход в кабинет не доказывает, что ключ разрешает любую модель. При утечке отзовите ключ в кабинете, создайте новый и обновите все использующие его приложения. Удаление из последнего коммита не удаляет секрет из истории. Поддержке передавайте только обезличенные ошибки, время и идентификатор запроса. ## Примеры запросов и конфигурации Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере. ```bash # Добавьте в ~/.zshrc или ~/.bashrc; действует только на этом компьютере export ONEZHE_API_KEY="sk-YOUR_API_KEY" ``` ```powershell [Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-YOUR_API_KEY", "User") # Действует после открытия нового терминала ``` ```bash # Добавьте .env в .gitignore ONEZHE_API_KEY=sk-YOUR_API_KEY ```