Создание и защита ключей API
Где создать ключ, как ограничить доступ и что делать при утечке.
Создайте ключ в разделе ключей API кабинета. Укажите понятное имя и доступные ограничения модели и расхода. Для каждого приложения лучше использовать отдельный ключ, чтобы его можно было отозвать независимо.
Хранение и использование
Раздел «Хранение и использование»Копируйте полный ключ в секретное поле приложения или переменную окружения. Не встраивайте ключ в браузерный JavaScript, мобильный клиент, общедоступный workflow или репозиторий. Для сайта вызывайте API со своего сервера; пользовательский браузер должен обращаться к вашему серверу.
Кнопки импорта и копирования настроек могут содержать полный ключ, даже если предварительный просмотр маскирует его. Проверяйте целевой клиент и не пересылайте такие ссылки.
Если доступ не работает
Раздел «Если доступ не работает»При 401 проверьте наличие ключа в новом процессе, отсутствие лишних пробелов и правильный заголовок. При 403 или недоступной модели проверьте права, ограничения и баланс. Успешный вход в кабинет не доказывает, что ключ разрешает любую модель.
При утечке отзовите ключ в кабинете, создайте новый и обновите все использующие его приложения. Удаление из последнего коммита не удаляет секрет из истории. Поддержке передавайте только обезличенные ошибки, время и идентификатор запроса.
Примеры запросов и конфигурации
Раздел «Примеры запросов и конфигурации»Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.
# Добавьте в ~/.zshrc или ~/.bashrc; действует только на этом компьютереexport ONEZHE_API_KEY="sk-YOUR_API_KEY"[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-YOUR_API_KEY", "User")# Действует после открытия нового терминала# Добавьте .env в .gitignoreONEZHE_API_KEY=sk-YOUR_API_KEY