Ключи и окружения

Проект Langsys выпускает два вида API-ключей. Какой из них использовать, зависит от того, что вы делаете: находите новые фразы (разработка) или просто показываете готовые переводы (рабочая среда). Оба ключа создаются в панели управления, а как это сделать, показано в кратком руководстве.

Смотреть · 1:30 Ключи и окружения

Два ключа — две задачи

Тип ключа	Умеет	Использование в
Запись	Получайте переводы и регистрируйте вновь обнаруженные фразы в проекте.	Для разработки / серверной стороны. Не включайте его в публичные бандлы.
Только чтение	Только получение переводов. Ничего нельзя зарегистрировать или изменить.	Продакшен / браузер. Безопасно использовать в клиентском коде.

Почему ключ только для чтения безопасен в браузере. Он физически не может записывать — максимум, что можно сделать с его помощью, это прочитать те же публичные переводы, которые уже видят ваши пользователи. В этом и состоит смысл разделения.

Типичный процесс

Смотреть · 1:30 API-ключи в продакшене

Разрабатывайте с ключом записи. По мере создания интерфейса новые фразы обнаруживаются, регистрируются и автоматически переводятся на ваши целевые локали.
Когда текст устоится, переключите развёрнутое приложение на ключ только для чтения.
Пользователи получают готовый каталог; ничто из того, что у них есть, не может изменить ваш проект.

Разработка

# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key   # discovers + registers new phrases

Продакшен

# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key   # only fetches — safe to ship

Что содержит проект

Смотреть · 2:24 Настройки ИИ-переводчика

Ключ аутентифицируется в рамках проекта, который определяет набор переводов для вашего приложения:

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

Запускаете эти демо локально? Направьте SDK на свой экземпляр с ключом только для чтения — см. .env.example в проекте. Иначе панели работают в демо-режиме (только исходный текст).