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