Primeros pasos
Antes de instalar cualquier paquete necesitas tres cosas: una cuenta, un proyecto con su IA configurada y un API token del proyecto.
1. Crea tu cuenta
Regístrate gratis en translateprojects.dev/accounts/register. No se pide tarjeta de crédito.
2. Crea un proyecto
En el panel, entra en Proyectos y crea uno nuevo. Usa un proyecto por cada aplicación o sitio que quieras traducir.
| Campo | Para qué sirve |
|---|---|
| Nombre del proyecto | Un nombre para reconocerlo en el panel. |
| Descripción del proyecto | Contexto para la IA: de qué trata, quién lo lee y el tono. Una buena descripción mejora las traducciones. |
| Categoría | También es contexto para la IA (por ejemplo, documentación técnica o videojuegos). Si no está en la lista, escribe una nueva. |
| Idioma por defecto | El idioma en el que escribes tus textos. Debe coincidir con el idioma base que configures en el paquete. |
| Proveedor de IA | Claude, OpenAI, DeepSeek o Gemini. |
| Modelo de IA para traducir | El modelo de ese proveedor que hará las traducciones. |
| API key de tu proveedor de IA | La key de tu cuenta en ese proveedor. Se guarda cifrada y solo se usa para los textos que no están en la red compartida. |
Los idiomas destino se añaden solos la primera vez que el paquete los pide. Si desactivas uno en el panel, la API rechaza ese idioma hasta que lo vuelvas a activar.
3. Genera el API token
Dentro del proyecto, abre Tokens API y pulsa Crear nuevo token. Ese token identifica al proyecto ante la API; no es la key de tu proveedor de IA.
Guárdalo en la variable de entorno TRANSLATE_PROJECTS_API_KEY:
export TRANSLATE_PROJECTS_API_KEY=tu_token
O en el archivo .env de tu proyecto. Laravel lo lee solo; los comandos de Node (React, Next.js, Astro, Docusaurus) y Django no, así que exporta la variable o cárgala tú (en Node 20 o superior, con node --env-file=.env).
TRANSLATE_PROJECTS_API_KEY=tu_token
No escribas el token en el código ni lo subas al repositorio. Léelo siempre de la variable de entorno; en CI guárdalo como secreto. Si se filtra, desactívalo en Tokens API y crea otro.