Claves y entornos

Un proyecto de Langsys emite dos tipos de clave de API. Cuál uses depende de si estás descubriendo frases nuevas (desarrollo) o solo mostrando traducciones terminadas (producción). Ambas se generan en el panel; la Guía de inicio rápido te explica cómo.

Ver · 1:30 Claves y entornos

Dos claves, dos funciones

Tipo de clave	Puede hacerlo	Úsalo en
Escribir	Obtén las traducciones y registra en el proyecto las frases recién descubiertas.	Para desarrollo y del lado del servidor. Mantenla fuera de los paquetes públicos.
Solo lectura	Solo obtiene traducciones. No puede registrar ni modificar nada.	Producción / el navegador. Es seguro incluirla en el código del cliente.

Por qué una clave de solo lectura es segura en el navegador. Físicamente no puede escribir: lo peor que alguien puede hacer con ella es leer las mismas traducciones públicas que ya ven tus usuarios. Ese es todo el sentido de la separación.

El flujo habitual

Ver · 1:30 Claves de API en producción

Desarrolla con una clave de escritura. A medida que construyes la interfaz, las frases nuevas se detectan, se registran y se traducen automáticamente a tus idiomas de destino.
Cuando el texto quede definitivo, cambia la app desplegada a una clave de solo lectura.
Los usuarios obtienen el catálogo terminado; nada de lo que tienen puede modificar tu proyecto.

Desarrollo

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

Producción

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

Qué contiene un proyecto

Ver · 2:24 Configuración del traductor con IA

La clave se autentica contra un proyecto, que define el universo de traducción de tu aplicación:

un idioma base: el idioma en el que están escritas tus frases fuente;
un conjunto de locales de destino: todos los idiomas a los que se traducen automáticamente las frases;
configuración de traducción automática: el nivel del proveedor y si las frases nuevas se traducen automáticamente.

¿Ejecutas estas demos de forma local? Apunta el SDK a tu propia instancia con una clave de solo lectura; consulta el archivo .env.example del proyecto. De lo contrario, los paneles se ejecutan en modo demo (solo texto original).