Documentación

Primeros pasos con l10n.dev

l10n.dev es una plataforma de localización con IA creada para desarrolladores y equipos de localización. Traduce tus archivos i18n mientras preserva las claves, la estructura, los marcadores de posición y las formas plurales, ya sea desde tu agente de IA, tu terminal, tu flujo de trabajo de CI o el espacio de trabajo web. Esta página te guía a través de tu primera traducción y te muestra lo que la plataforma puede hacer una vez que estés configurado.

Paso 1: Cree una cuenta

Una cuenta por persona, por favor. Te pedimos amablemente que no crees cuentas duplicadas; los sistemas automatizados las detectan y bloquean para que el nivel gratuito se mantenga justo y disponible para todos.

Crea tu API key

Todo lo que está fuera del espacio de trabajo web (el agente de IA, la CLI, la GitHub Action, los plugins y la API) se autentica con una API key. Crea una en la API Keys página y guárdala en un lugar seguro: la pegarás en la configuración de tu agente, la configuración de tu CLI o tus secretos de CI. Puedes revocar y volver a emitir una clave en cualquier momento.

Paso 2: Elige cómo quieres localizar

Hay tres formas de usar l10n.dev. Comparten el mismo motor de traducción, saldo de caracteres, glosarios e instrucciones lingüísticas, así que elige la que mejor se adapte a tu flujo de trabajo hoy y combínalas más tarde.

Agente de localización con IA (MCP)

Conectar tu agente de IA a nuestro servidor MCP lo convierte en una herramienta de localización profesional. En lugar de traducir cadenas por sí mismo (consumiendo ventana de contexto y desviándose entre ejecuciones), el agente llama a l10n.dev como un motor de traducción dedicado y recibe un archivo terminado. Es como tener un experto en localización en tu equipo.

  • Eficiente en tokens: el contenido traducido nunca pasa por la ventana de contexto de tu agente, por lo que tu asistente de codificación sigue trabajando en el código.
  • Garantías de formato: las claves, el orden, los marcadores de posición y las formas plurales regresan intactos; nada de JSON roto que limpiar después.
  • Memoria persistente: los glosarios y las instrucciones lingüísticas se almacenan de nuestro lado, por lo que la calidad no depende de lo que el agente recuerde.

La configuración es un solo comando; aquí está para Claude Code (Cursor, Windsurf, Copilot, Claude Desktop y Codex están cubiertos en la guía):

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

Luego simplemente pregúntale a tu agente: "Traduce src/i18n/en al alemán y al japonés". Detectará la estructura de tu proyecto, traducirá y escribirá los archivos por ti.

Lee la guía del Agente de localización con IA

CLI y GitHub Actions

El paquete npm ai-l10n lleva la localización a tu terminal y a tu flujo de trabajo de CI/CD. Traduce un archivo manualmente mientras desarrollas y luego mueve el mismo comando a un flujo de trabajo para que las nuevas cadenas se localicen antes de que lleguen a un revisor.

  • Detección de estructura del proyecto: apúntalo a tu archivo de origen y encontrará tus idiomas de destino existentes automáticamente.
  • Incremental por defecto: con translateOnlyNewStrings, solo se envían y facturan las cadenas añadidas o modificadas.
  • Listo para el flujo de trabajo: funciona igual localmente, en GitHub Actions, GitLab CI o Jenkins.

Instala el paquete, guarda tu API key y traduce tu primer archivo:

npm install ai-l10n

npx ai-l10n config --api-key YOUR_API_KEY

# Auto-detects target languages from your project structure
npx ai-l10n translate ./locales/en.json --update

# Or name them explicitly
npx ai-l10n translate ./locales/en.json --languages es,fr,de --update

Para traducir en cada push, añade nuestra GitHub Action a tu flujo de trabajo:

name: Auto-translate i18n files

on:
  push:
    branches: [main]
    paths: ['locales/en/**']

permissions:
  contents: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: l10n-dev/ai-l10n@v1
        with:
          api-key: ${{ secrets.L10N_API_KEY }}
          config-file: 'ai-l10n.config.json'
          pull-request: false

Lee la guía de automatización de localización

Espacio de trabajo web

El espacio de trabajo es la forma más rápida de ver lo que produce el servicio: sin API key, sin instalación. También es donde gestionas tus archivos, glosarios, instrucciones y saldo.

  1. Sube tu archivo i18n: JSON, YAML, PO, XLIFF, ARB, Markdown o texto plano.
  2. Elige el idioma de origen y uno o más idiomas de destino.
  3. Opcionalmente, adjunta un glosario e instrucciones lingüísticas, y habilita la traducción solo de cadenas nuevas.
  4. Presiona Traducir, observa el progreso, luego descarga el resultado o cópialo directamente en tu repositorio.

Abrir el espacio de trabajo

Paso 3: Ajusta la calidad de la traducción

Desde el primer momento, la IA ya ve las claves circundantes y la estructura del archivo como contexto. Estas dos características te permiten fijar el vocabulario y la voz de tu producto, y se aplican a cada ruta anterior: agente, CLI, espacio de trabajo y API por igual.

Glosario con IA

Un glosario define cómo deben traducirse los nombres de tus productos, nombres de funciones y términos del dominio. Habilita la generación de glosarios y l10n.dev creará uno automáticamente a partir de tu contenido de origen y traducido, guardándolo como el glosario persistente para ese par de idiomas, para que toda traducción futura se mantenga consistente y alineada con la marca. También puedes importar tu propio glosario o generar uno con IA.

Gestionar glosarios

Instrucciones lingüísticas

Las instrucciones lingüísticas le dicen a la IA cómo escribir: formal o informal, qué forma de dirigirse usar, cómo manejar nombres de marca, convenciones específicas del producto o cualquier otra cosa que defina tu voz. Escríbelas una vez y se aplicarán a cada traducción para ese idioma.

Gestionar instrucciones lingüísticas

Regla general: usa un glosario para qué debe ser una palabra, e instrucciones lingüísticas para cómo debe sonar todo el texto.

Qué más obtienes

Traducción incremental

Rastreamos tus cadenas de origen por contenido, por lo que volver a ejecutar una traducción solo envía lo que realmente cambió. Las traducciones existentes y revisadas permanecen intactas, tus diffs de Git se mantienen pequeños y solo se te factura por el texto nuevo. No almacenamos tu contenido; solo se aplica hash para detectar cambios, por lo que tus cadenas de origen permanecen privadas.

165 idiomas y todos los formatos comunes

Traduce a 165 idiomas, incluidos aquellos menos comunes donde es difícil encontrar traductores humanos. JSON, YAML, PO, XLIFF, ARB, Markdown, texto plano y especificaciones OpenAPI se manejan de forma nativa, incluidos los mensajes ICU y las formas plurales CLDR completas.

Garantía de formato y múltiples LLMs

Cada resultado se valida contra el origen: si se pierde un marcador de posición, una clave o la estructura, el fragmento se vuelve a intentar automáticamente. Los archivos grandes se dividen en fragmentos que mantienen su contexto, y operamos varios LLMs para que cada idioma y tipo de contenido obtenga el modelo que mejor lo maneja.

Integraciones para todo tu equipo

La localización no es solo una tarea de desarrolladores. Lleva l10n.dev a las herramientas que tu equipo ya usa: plugins para Figma, Obsidian, una extensión de VS Code, el paquete NPM, MCP y una API REST documentada.

Explorar todas las integraciones

Tu privacidad importa

No almacenamos tus datos de traducción. Cuando traduces archivos en el espacio de trabajo, mantienes el control total sobre ellos: elimínalos en cualquier momento.

Gestionar tus archivos

Instancia dedicada

Si tu organización necesita infraestructura aislada, tu propia base de datos y almacenamiento, tus propias implementaciones de modelos o garantías de cumplimiento personalizadas, podemos ejecutar l10n.dev como una instancia dedicada para ti.

Leer sobre instancias dedicadas

Nivel gratuito y paquetes

Cada cuenta obtiene 10,000 caracteres gratis cada mes. Sin cargos, sin necesidad de tarjeta de crédito; eso es suficiente para localizar una pequeña aplicación o para evaluar adecuadamente la calidad antes de comprometerte.

Si necesita más que la cuota mensual gratuita, puede comprar un paquete para aumentar su saldo de caracteres. Use la dirección de correo electrónico asociada con el pedido para iniciar sesión y acceder a sus beneficios.

Paquetes disponibles:

  • 100K Characters
    Precio: $4.90
    Traduce 100,000 caracteres.*
  • 1M Characters
    Precio: $14.90
    Traduce 1,000,000 caracteres.*
  • 5M Characters
    Precio: $39.90
    Traduce 5,000,000 caracteres.*

*Cada paquete es válido por 90 días, y el saldo restante se transfiere cuando compras de nuevo antes de que expire.

Comparar todos los paquetes y precios

Qué hacer a continuación

Elige el siguiente paso que coincida con cómo planeas trabajar, o simplemente traduce un archivo y mira el resultado por ti mismo.

¿Por qué elegir l10n.dev?

l10n.dev combina el poder de la IA con herramientas fáciles de usar para agilizar su proceso de localización. Ya sea que sea un desarrollador o parte de un equipo de localización, nuestra plataforma garantiza traducciones precisas, eficientes y asequibles adaptadas a sus necesidades.