Документация Bring Your Own Key (BYOK)

Bring Your Own Key (BYOK)

Использование собственного ключа (BYOK) для плана Enterprise: подключите ключ API Google Gemini, чтобы получить дополнительные кредиты, расширенный выбор моделей и прямое выставление счетов.

Обзор

Bring Your Own Key (BYOK) — это функция уровня Enterprise, которая позволяет вашей организации подключить ключ API Google Gemini напрямую к i1n. В этом случае AI-переводы будут выполняться через вашу собственную учетную запись Google AI, а не через общий пул вычислений i1n.

Когда функция BYOK активна, ваш корпоративный контракт получает бонус +50% к кредитам на ИИ-перевод и ключам перевода сверх лимитов, предусмотренных договором. Расходы на инференс, взимаемые Google, оплачиваются через ваш собственный аккаунт Google; i1n продолжает обеспечивать оркестрацию, кэширование, защиту переменных и соблюдение тональности бренда.

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

Зачем использовать BYOK

Функцию BYOK стоит включить, если выполняется любое из следующих условий: у вашей организации уже есть соглашение с Google Cloud или Google AI Studio, вам необходим прямой контроль расходов на базовый инференс или вы хотите получить первоочередной доступ к новейшим предварительным версиям моделей Gemini сразу после их выпуска компанией Google.

Бонус в +50% к кредитам и ключам означает, что корпоративный клиент с поддержкой BYOK фактически оплачивает только оркестрацию, в то время как расходы на инференс проходят через ваши существующие отношения с Google по биллингу — что обычно приводит к снижению совокупной стоимости владения при больших объемах перевода.

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

Доступные модели

После включения BYOK вы можете выбрать модель Gemini по умолчанию, используемую для перевода с помощью ИИ. Модель можно изменить в любой момент через панель управления, и это изменение будет применяться к последующим задачам перевода.

Gemini 2.5 Flash-Lite — рекомендуемая модель по умолчанию. Она обеспечивает оптимальный баланс между качеством перевода, задержкой и стоимостью для большинства задач локализации.

Gemini 3 Flash (предварительная версия) подходит для качественного общего перевода, когда задержка по-прежнему имеет значение. Gemini 3.1 Pro (предварительная версия) обеспечивает наивысшее доступное качество и рекомендуется для работы с нюансированным или критически важным контентом. Gemini 3.1 Flash-Lite (предварительная версия) — самый быстрый вариант, идеально подходящий для очень больших объемов данных, где пропускная способность имеет первостепенное значение.

Модели предварительного просмотра могут быть изменены компанией Google. i1n отслеживает новые релизы Gemini и добавляет их на панель управления по мере их появления — для переключения моделей не требуется внесение изменений в договор.

Настройка

Шаг 1 — Создайте ключ Gemini API. Войдите в Google AI Studio (aistudio.google.com), откройте раздел API keys и создайте новый ключ, привязанный к проекту, который вы хотите использовать для оплаты.

Шаг 2 — Добавьте ключ в i1n. В панели управления откройте настройки организации, перейдите в раздел BYOK, вставьте API-ключ и сохраните изменения. Сразу после отправки ключ шифруется в состоянии покоя.

Шаг 3 — Выберите модель по умолчанию. Выберите одну из доступных моделей Gemini (см. «Доступные модели» выше). Выбор вступит в силу для всех последующих задач перевода в CLI, на сервере MCP и в панели управления.

Шаг 4 — Проверка. Запустите i1n push --translate для небольшого набора ключей и убедитесь, что задача завершена. В представлении использования панели управления отображается, был ли каждый перевод обработан через BYOK или через стандартный путь вывода i1n.

Чтобы сменить ключ, замените его в панели управления в любое время — текущие задачи продолжат использовать предыдущий ключ до завершения. Чтобы полностью отключить BYOK, удалите ключ из панели управления; последующие переводы будут автоматически выполняться через стандартный путь инференса i1n.

Связанное