Inicio rápido: proyecto y claves
Todos los playgrounds de este sitio funcionan sobre un proyecto de demostración compartido, así que puedes explorar sin una cuenta. Para traducir tu propia app necesitas tres cosas del panel de Langsys: un proyecto, una clave de escritura y una clave de solo lectura. Dos minutos, una sola vez.
La configuración
- Inicia sesión en app.langsys.dev; crea una cuenta si no tienes una.
- Crea un proyecto. Elige el idioma base (el idioma en que están escritas tus frases de origen) y los idiomas de destino para los que quieres traducciones. Copia el ID del proyecto.
- Genera dos claves de API para el proyecto: una clave de escritura y una de solo lectura. Esta separación es todo el modelo de seguridad; Claves y entornos explica por qué.
- Agrégalas a tu env e instala el SDK para tu stack. Desarrolla con la clave de escritura para que las frases nuevas se registren y se traduzcan automáticamente mientras construyes; publica con la clave de solo lectura.
# .env.local — development (Vite-style names; adjust the prefix to your bundler)
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 in the browser# .env (Laravel, or your PHP app's environment)
LANGSYS_PROJECT_ID=your-project-id
LANGSYS_API_KEY=write-key # server-side, so the write key can stay —
# switch to read-only anywhere that must not
# register phrases (e.g. a public sandbox)¿Qué clave va dónde? El navegador solo recibe la clave de solo lectura: puede obtener traducciones y nada más, así que es seguro incluirla en un bundle público. La clave de escritura registra frases nuevas, por lo que debe usarse únicamente en desarrollo y en servidores.
Luego elige tu SDK
Cada página del SDK comienza en Install y supone exactamente esta configuración: el id del proyecto y la clave en tu env:
Frontend
TypeScript, React, Vue y Svelte, cada uno con un playground interactivo.
Backend
PHP y Laravel: la página llega ya localizada.
Metaframeworks
Next.js, Nuxt y SvelteKit: carga los datos iniciales en el servidor e hidrata en el cliente.
¿Eres nuevo en las ideas de fondo? Empieza con Conceptos (la frase es la clave, el descubrimiento de tokens y el almacén de locales) y luego vuelve aquí.