Собственный ключ (BYOK)
Сохраните ключи организации для Anthropic, OpenAI, Google и Mistral AI, чтобы использовать их для запросов на локализацию и оплачивать токены напрямую провайдеру.
Используйте собственный API-ключ провайдера моделей для локализации. Добавьте ключ организации на странице BYOK в настройках, затем выберите модель для локализации. Запросы к моделям этого провайдера будут выполняться с вашим ключом, а за токены вы будете платить напрямую провайдеру. Доступно на тарифном плане Enterprise.
Поддерживаемые провайдеры: Anthropic, OpenAI, Google и Mistral AI.
Локализация с вашим ключом #
Для других возможностей, например AI-эвалюаторов и рекомендаций для движка, не нужно добавлять ключ провайдера или выбирать модель.
Оплата #
Когда локализация выполняется с вашим ключом, за токены модели вы платите провайдеру — Lingo.dev не берёт плату за использование модели. При этом плата за инфраструктуру Lingo.dev для локализованного контента сохраняется. Если ваш ключ не используется, стоимость работы модели списывается с ваших кредитов Lingo.dev.
Кто может управлять ключами #
Работа со страницей BYOK зависит от двух условий:
- Право доступа: функция BYOK должна быть включена для организации (тарифный план Enterprise). Страница всегда отображается в настройках. Без этого права на ней появляется сообщение «Собственные ключи провайдеров недоступны на вашем тарифном плане», а сохранить ключ не удастся.
- Разрешение: чтобы добавлять, заменять, включать, отключать и удалять ключи, в роли участника должно быть разрешение Управление настройками (
org:manage_settings). Без RBAC у всех участников роль «Владелец», которая даёт это разрешение.
Все участники могут видеть, для каких провайдеров добавлен ключ и используется ли он. Изменить ключи с помощью API-ключа организации не удастся. Для этого войдите в личную учётную запись.
Как добавить ключ #
- Откройте страницу BYOK в разделе Настройки.
- Выберите Добавить ключ рядом с провайдером.
- Вставьте API-ключ и сохраните его.
При сохранении Lingo.dev проверяет ключ у провайдера. Если провайдер не принимает ключ, он не сохраняется. Проверьте ключ в своей учётной записи у провайдера и вставьте ещё раз.
Отображение ключа
После сохранения ключ больше не показывается целиком. На странице видны только последние четыре символа и время обновления ключа. Чтобы изменить его, выберите Заменить и вставьте новый ключ.
Как использовать модели провайдера #
Ваш ключ используется, когда запрос на локализацию обращается к модели этого провайдера. Чтобы использовать свой ключ на шагах локализации движка, выберите модель этого провайдера в конфигурации моделей движка.
| Ситуация | Что происходит |
|---|---|
| У вас есть ключ провайдера модели, он включён и даёт доступ к этой модели | Запрос выполняется с вашим ключом |
| Нет ключа этого провайдера | Локализация с моделью из каталога расходует ваши кредиты Lingo.dev |
| Ключ отключён | Локализация с моделью из каталога расходует ваши кредиты Lingo.dev |
| Модели нет в каталоге Lingo.dev, а ваш ключ её провайдера отсутствует или отключён | Локализация с этой моделью завершается ошибкой, потому что ключ Lingo.dev не даёт к ней доступа |
| Провайдер не даёт доступа к модели по вашему ключу | Для модели из каталога запрос повторяется за счёт ваших кредитов Lingo.dev. Для модели вне каталога запрос завершается ошибкой |
Метка BYOK
Ваш ключ используется, только если провайдер даёт по нему доступ к модели с точно таким же ИД, как в движке. В списках выбора моделей и в конфигурации моделей движка доступные по вашему ключу модели отмечены меткой BYOK. Сохранённая модель с меткой Не BYOK недоступна по вашему ключу, поэтому локализация с ней расходует ваши кредиты Lingo.dev. Сохранённой модели с меткой Нужен ключ Mistral AI нет в каталоге моделей Lingo.dev. Она работает только с вашим ключом Mistral AI, но ключ отсутствует или отключён. Добавьте или включите ключ либо выберите другую модель.
Отсутствие или отключение ключа никогда не останавливает локализацию с моделью из каталога.
Модели вне каталога #
В списках выбора моделей также доступны чат-модели, к которым даёт доступ ваш ключ Mistral AI, но которых нет в каталоге моделей Lingo.dev, например mistralai/zai-glm-5-3. Они отмечены меткой BYOK и отображаются как provider/model — по одной записи на модель, с ИД, который ей присвоил Mistral AI. Модель, сохранённая под одним из альтернативных имён, например mistralai/zai-glm-latest, тоже работает с вашим ключом.
Эти модели работают только с вашим ключом, потому что собственный ключ Lingo.dev не даёт к ним доступа. Пока только в списке моделей Mistral AI указано, какие из них поддерживают чат, поэтому ключи других провайдеров не добавляют моделей вне каталога.
Если провайдер отклоняет ваш ключ #
Эти ошибки останавливают запрос на локализацию. Lingo.dev не повторяет его за счёт ваших кредитов и не переходит к следующей модели в конфигурации моделей движка. В сообщении об ошибке указаны провайдер и то, что нужно исправить.
| Ситуация | Что делать |
|---|---|
| Провайдер ограничивает частоту запросов по вашему ключу | Повторите попытку через несколько минут или увеличьте допустимую частоту запросов для ключа у провайдера |
| В вашей учётной записи у провайдера закончились кредиты или исчерпана квота | Пополните баланс кредитов или увеличьте квоту у провайдера, затем повторите попытку |
| Провайдер отклоняет ваш ключ, например потому, что он отозван | Замените ключ на странице BYOK в разделе Настройки, затем повторите попытку |
| Lingo.dev не удаётся прочитать сохранённый ключ | Сохраните ключ ещё раз на странице BYOK в разделе Настройки, затем повторите попытку |
Это ваши лимиты и ваша учётная запись, поэтому повторная попытка за счёт кредитов Lingo.dev скрыла бы от вас проблему.
Как отключить ключ #
Отключите ключ, чтобы перестать использовать его, не удаляя. На странице появится статус Отключён, а локализация с моделями этого провайдера из каталога будет расходовать ваши кредиты Lingo.dev, пока вы снова не включите ключ. Модели вне каталога не работают, пока ключ отключён.
Если ваш тарифный план больше не позволяет использовать собственные ключи, у сохранённого ключа появляется статус Сохранён, не используется. Локализация с моделями этого провайдера из каталога расходует ваши кредиты Lingo.dev, а модели вне каталога не работают. Ключ хранится, пока вы его не удалите.
Как удалить ключ #
Выберите Удалить ключ. Ключ будет удалён из Lingo.dev. Локализация с моделями этого провайдера из каталога снова будет расходовать ваши кредиты Lingo.dev, а модели вне каталога перестанут работать.
Отзовите ключ у провайдера
Удаление ключа из Lingo.dev не отзывает его у провайдера. Ключ остаётся действительным, пока вы не отзовёте его там.