Primeiros Passos com o l10n.dev

l10n.dev é uma plataforma de localização por IA criada para desenvolvedores e equipes de localização. Ela traduz seus arquivos i18n preservando chaves, estrutura, placeholders e formas plurais — a partir do seu Agente de Localização por IA, seu terminal, seu pipeline de CI ou da área de trabalho web. Esta página orienta você em sua primeira tradução e mostra o que a plataforma pode fazer assim que você estiver configurado.

Passo 1: Crie uma Conta

Criar sua chave de API

Tudo fora da área de trabalho web — o Agente de Localização por IA, a CLI, o GitHub Action, as extensões e a API — autentica-se com uma chave de API. Crie uma na chave de API página e mantenha-a em um local seguro: você a colará na configuração do seu agente, na configuração da sua CLI ou nos segredos do seu CI. Você pode revogar e reemitir uma chave a qualquer momento.

Passo 2: Escolha como você deseja realizar a localização

Existem três maneiras de usar o l10n.dev. Elas compartilham o mesmo motor de tradução, saldo de caracteres, glossários e instruções linguísticas — então escolha a que melhor se adapta ao seu fluxo de trabalho hoje e misture-as mais tarde.

Agente de Localização por IA (MCP)

Conectar seu Agente de Localização por IA ao nosso servidor MCP o transforma em uma ferramenta de localização profissional. Em vez de traduzir strings por conta própria — consumindo janela de contexto e perdendo consistência entre execuções — o agente chama o l10n.dev como um motor de tradução dedicado e recebe um arquivo finalizado de volta. É como ter um especialista em localização em sua equipe.

• Eficiente em tokens: o conteúdo traduzido nunca passa pela janela de contexto do seu agente, portanto, seu assistente de codificação continua trabalhando no código.
• Garantias de formato: chaves, ordenação, placeholders e formas plurais retornam intactos — sem JSON quebrado para corrigir depois.
• Memória persistente: glossários e instruções linguísticas são armazenados do nosso lado, para que a qualidade não dependa do que o agente se lembra.

A configuração é um comando único — aqui está para o Claude Code (Cursor, Windsurf, Copilot, Claude Desktop e Codex estão cobertos no guia):

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

Em seguida, basta pedir ao seu agente: "Traduza src/i18n/en para alemão e japonês." Ele detectará a estrutura do seu projeto, traduzirá e escreverá os arquivos para você.

Leia o guia do Agente de Localização por IA

CLI & GitHub Actions

O pacote npm ai-l10n traz a localização para o seu terminal e seu pipeline de CI/CD. Traduza um arquivo manualmente enquanto desenvolve e, em seguida, mova o mesmo comando para um fluxo de trabalho para que novas strings sejam localizadas antes mesmo de chegarem a um revisor.

• Detecção de estrutura de projeto: aponte para o seu arquivo de origem e ele encontrará seus idiomas de destino existentes automaticamente.
• Incremental por padrão: com translateOnlyNewStrings, apenas strings adicionadas ou alteradas são enviadas e cobradas.
• Pronto para pipeline: funciona da mesma forma localmente, no GitHub Actions, GitLab CI ou Jenkins.

Instale o pacote, armazene sua chave de API e traduza seu primeiro arquivo:

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 traduzir a cada push, adicione nosso GitHub Action ao seu fluxo de trabalho:

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

Leia o guia de automação de localização

Área de trabalho web

A área de trabalho é a maneira mais rápida de ver o que o serviço produz — sem chave de API, sem instalação. É também onde você gerencia seus arquivos, glossários, instruções e saldo.

1. Faça upload do seu arquivo i18n — JSON, YAML, PO, XLIFF, ARB, Markdown ou texto simples.
2. Escolha o idioma de origem e um ou mais idiomas de destino.
3. Opcionalmente, anexe um glossário e instruções linguísticas, e habilite a tradução apenas de novas strings.
4. Pressione Traduzir, acompanhe o progresso e baixe o resultado ou copie-o diretamente para o seu repositório.

Abrir a área de trabalho

Passo 3: Ajuste a qualidade da tradução

Pronta para uso, a IA já vê as chaves ao redor e a estrutura do arquivo como contexto. Esses dois recursos permitem que você fixe o vocabulário e a voz do seu produto, e eles se aplicam a todos os caminhos acima — agente, CLI, área de trabalho e API.

Glossário por IA

Um glossário define como os nomes dos seus produtos, nomes de recursos e termos de domínio devem ser traduzidos. Habilite a geração de glossário e o l10n.dev cria um automaticamente a partir do seu conteúdo de origem e traduzido, salvando-o como o glossário ativo para aquele par de idiomas — para que toda tradução futura permaneça consistente e com a voz da marca. Você também pode importar seu próprio glossário ou gerar um com IA.

Gerenciar glossários

Instruções linguísticas

As instruções linguísticas dizem à IA como escrever: formal ou informal, qual forma de tratamento usar, como lidar com nomes de marcas, convenções específicas de produtos ou qualquer outra coisa que defina sua voz. Escreva-as uma vez e elas serão aplicadas a cada tradução para aquele idioma.

Gerenciar instruções linguísticas

Regra prática: use um glossário para o que uma palavra deve se tornar, e instruções linguísticas para como todo o texto deve soar.

O que mais você recebe

Tradução incremental

Rastreamos suas strings de origem por conteúdo, então reexecutar uma tradução envia apenas o que realmente mudou. Traduções existentes e revisadas permanecem intocadas, seus diffs do Git permanecem pequenos e você só é cobrado pelo novo texto. Não armazenamos seu conteúdo; ele é apenas hashado para detectar alterações, para que suas strings de origem permaneçam privadas.

165 idiomas e todos os formatos comuns

Traduza para 165 idiomas, incluindo aqueles menos suportados onde tradutores humanos são difíceis de encontrar. JSON, YAML, PO, XLIFF, ARB, Markdown, texto simples e especificações OpenAPI são todos tratados nativamente — incluindo mensagens ICU e formas plurais CLDR completas.

Garantia de formato e múltiplos LLMs

Cada resultado é validado em relação à origem: se um placeholder, uma chave ou a estrutura for perdida, o bloco é tentado novamente automaticamente. Arquivos grandes são divididos em blocos que mantêm seu contexto, e operamos vários LLMs para que cada idioma e tipo de conteúdo receba o modelo que melhor o manipula.

Integrações para toda a sua equipe

A localização não é apenas uma tarefa de desenvolvedor. Traga o l10n.dev para as ferramentas que sua equipe já usa — extensões para Figma, Obsidian, uma extensão para VS Code, o pacote NPM, MCP e uma API REST documentada.

Navegar por todas as integrações

Sua privacidade importa

Não armazenamos seus dados de tradução. Quando você traduz arquivos na área de trabalho, você mantém controle total sobre eles — exclua-os a qualquer momento.

Gerenciar seus arquivos

Instância dedicada

Se sua organização precisa de infraestrutura isolada, seu próprio banco de dados e armazenamento, suas próprias implantações de modelo ou garantias de conformidade personalizadas, podemos executar o l10n.dev como uma instância dedicada para você.

Leia sobre instâncias dedicadas

Plano gratuito e pacotes

Cada conta recebe 10,000 caracteres grátis todos os meses. Sem cobranças, sem necessidade de cartão de crédito — isso é suficiente para localizar um pequeno aplicativo ou avaliar adequadamente a qualidade antes de se comprometer.

Se você precisar de mais do que a cota mensal gratuita, pode comprar um pacote para aumentar seu saldo de caracteres. Use o endereço de e-mail associado ao pedido para fazer login e acessar seus benefícios.

Pacotes disponíveis:

• 100K Characters
  Preço: $4.90
  Traduza 100,000 caracteres.*
• 1M Characters
  Preço: $14.90
  Traduza 1,000,000 caracteres.*
• 5M Characters
  Preço: $39.90
  Traduza 5,000,000 caracteres.*

*Cada pacote é válido por 90 dias, e o saldo não utilizado é transferido quando você compra novamente antes do vencimento.

Comparar todos os pacotes e preços

Próximos passos

Escolha o próximo passo que corresponde a como você planeja trabalhar — ou apenas traduza um arquivo e veja o resultado por si mesmo.

Por que escolher o l10n.dev?

O l10n.dev combina o poder da IA com ferramentas fáceis de usar para otimizar seu processo de localização. Seja você um desenvolvedor ou parte de uma equipe de localização, nossa plataforma garante traduções precisas, eficientes e acessíveis, adaptadas às suas necessidades.