Documentazione

Per iniziare con l10n.dev

l10n.dev è una piattaforma di localizzazione basata su IA creata per sviluppatori e team di localizzazione. Traduce i tuoi file i18n preservando chiavi, struttura, segnaposto e forme plurali — dal tuo Agente di localizzazione IA, dal tuo terminale, dalla tua pipeline CI o dall'area di lavoro web. Questa pagina ti guida attraverso la tua prima traduzione e mostra cosa può fare la piattaforma una volta configurata.

Passaggio 1: Crea un account

Un account a persona, per favore. Ti chiediamo gentilmente di non creare account duplicati: i sistemi automatizzati li rilevano e li bloccano affinché il piano gratuito rimanga equo e disponibile per tutti.

Crea la tua chiave API

Tutto ciò che è al di fuori dell'area di lavoro web — Agente di localizzazione IA, CLI, GitHub Action, plugin e API — si autentica con una chiave API. Creane una nella pagina chiavi API e conservala in un luogo sicuro: la incollerai nella configurazione del tuo agente, nella configurazione della tua CLI o nei segreti della tua CI. Puoi revocare e riemettere una chiave in qualsiasi momento.

Passaggio 2: Scegli come vuoi localizzare

Ci sono tre modi per utilizzare l10n.dev. Condividono lo stesso motore di traduzione, saldo caratteri, glossari e istruzioni linguistiche — quindi scegli quello più adatto al tuo flusso di lavoro oggi e combinali in seguito.

Agente di localizzazione IA (MCP)

Collegare il tuo Agente di localizzazione IA al nostro server MCP lo trasforma in uno strumento di localizzazione professionale. Invece di tradurre le stringhe autonomamente — consumando contesto e perdendo coerenza tra le esecuzioni — l'agente chiama l10n.dev come motore di traduzione dedicato e riceve indietro un file finito. È come avere un esperto di localizzazione nel tuo team.

  • Efficienza dei token: il contenuto tradotto non passa mai attraverso la finestra di contesto del tuo agente, così il tuo assistente alla programmazione continua a lavorare sul codice.
  • Garanzia di formato: chiavi, ordine, segnaposto e forme plurali tornano intatti — nessun JSON corrotto da pulire in seguito.
  • Memoria persistente: glossari e istruzioni linguistiche sono memorizzati dalla nostra parte, quindi la qualità non dipende da ciò che l'agente ricorda in quel momento.

La configurazione richiede un solo comando — ecco quello per Claude Code (Cursor, Windsurf, Copilot, Claude Desktop e Codex sono trattati nella guida):

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

Poi chiedi semplicemente al tuo agente: "Traduci src/i18n/en in tedesco e giapponese." Rileverà la struttura del tuo progetto, tradurrà e scriverà i file per te.

Leggi la guida dell'Agente di localizzazione IA

CLI & GitHub Actions

Il pacchetto npm ai-l10n porta la localizzazione nel tuo terminale e nella tua pipeline CI/CD. Traduci un file manualmente durante lo sviluppo, poi sposta lo stesso identico comando in un flusso di lavoro affinché le nuove stringhe vengano localizzate prima ancora di raggiungere un revisore.

  • Rilevamento della struttura del progetto: puntalo al tuo file sorgente e troverà automaticamente le tue varianti linguistiche di destinazione esistenti.
  • Incrementale per impostazione predefinita: con translateOnlyNewStrings vengono inviate e fatturate solo le stringhe aggiunte o modificate.
  • Pronto per la pipeline: funziona allo stesso modo localmente, in GitHub Actions, GitLab CI o Jenkins.

Installa il pacchetto, memorizza la tua chiave API e traduci il tuo primo file:

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

Per tradurre a ogni push, aggiungi la nostra GitHub Action al tuo flusso di lavoro:

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

Leggi la guida all'automazione della localizzazione

Area di lavoro web

L'area di lavoro è il modo più veloce per vedere cosa produce il servizio — nessuna chiave API, nessuna installazione. È anche il luogo in cui gestisci file, glossari, istruzioni e saldo.

  1. Carica il tuo file i18n — JSON, YAML, PO, XLIFF, ARB, Markdown o testo semplice.
  2. Scegli la lingua di origine e una o più lingue di destinazione.
  3. Facoltativamente, allega un glossario e istruzioni linguistiche e abilita la traduzione solo delle nuove stringhe.
  4. Premi Traduci, guarda l'avanzamento, quindi scarica il risultato o copialo direttamente nel tuo repository.

Apri l'area di lavoro

Passaggio 3: Ottimizza la qualità della traduzione

Fin da subito, l'IA vede le chiavi circostanti e la struttura del file come contesto. Queste due funzionalità ti consentono di fissare il vocabolario e la voce del tuo prodotto, e si applicano a ogni percorso sopra indicato — agente, CLI, area di lavoro e API.

Glossario basato su IA

Un glossario definisce come devono essere tradotti i nomi dei tuoi prodotti, i nomi delle funzionalità e i termini di dominio. Abilita la generazione del glossario e l10n.dev ne creerà uno automaticamente dal tuo testo sorgente e dal contenuto tradotto, salvandolo come glossario attivo per quella coppia di lingue — così ogni futura traduzione rimarrà coerente e in linea con il brand. Puoi anche importare il tuo glossario o generarne uno con l'IA.

Gestisci glossari

Istruzioni linguistiche

Le istruzioni linguistiche dicono all'IA come scrivere: formale o informale, quale forma di cortesia usare, come gestire i nomi dei brand, le convenzioni specifiche del prodotto o qualsiasi altra cosa che definisca la tua voce. Scrivile una volta e verranno applicate a ogni traduzione per quella lingua.

Gestisci istruzioni linguistiche

Regola pratica: usa un glossario per cosa deve diventare una parola e le istruzioni linguistiche per come dovrebbe suonare l'intero testo.

Cos'altro ottieni

Traduzione incrementale

Tracciamo le tue stringhe sorgente in base al contenuto, quindi rieseguire una traduzione invia solo ciò che è effettivamente cambiato. Le traduzioni esistenti e revisionate rimangono intatte, i tuoi diff Git rimangono piccoli e ti viene fatturato solo il nuovo testo. Non memorizziamo il tuo contenuto; viene solo sottoposto ad hashing per rilevare le modifiche, quindi le tue stringhe sorgente rimangono private.

165 lingue e ogni formato comune

Traduci in 165 lingue, incluse quelle meno supportate dove è difficile trovare traduttori umani. JSON, YAML, PO, XLIFF, ARB, Markdown, testo semplice e specifiche OpenAPI sono gestiti nativamente — inclusi i messaggi ICU e le forme plurali CLDR complete.

Garanzia di formato e modelli IA multipli

Ogni risultato viene convalidato rispetto all'origine: se un segnaposto, una chiave o la struttura vengono persi, il blocco viene ritentato automaticamente. I file di grandi dimensioni vengono suddivisi in blocchi che mantengono il loro contesto e utilizziamo diversi modelli IA in modo che ogni lingua e tipo di contenuto ottenga il modello che lo gestisce meglio.

Integrazioni per tutto il tuo team

La localizzazione non è solo un compito per sviluppatori. Porta l10n.dev negli strumenti che il tuo team utilizza già — plugin per Figma, Obsidian, un'estensione VS Code, il pacchetto NPM, MCP e un'API REST documentata.

Sfoglia tutte le integrazioni

La tua privacy è importante

Non memorizziamo i tuoi dati di traduzione. Quando traduci file nell'area di lavoro, mantieni il controllo completo su di essi — eliminali in qualsiasi momento.

Gestisci i tuoi file

Istanza dedicata

Se la tua organizzazione necessita di infrastruttura isolata, database e storage propri, distribuzioni di modelli personalizzate o garanzie di conformità specifiche, possiamo eseguire l10n.dev come istanza dedicata per te.

Leggi le informazioni sulle istanze dedicate

Piano gratuito e pacchetti

Ogni account riceve 10,000 caratteri gratuiti ogni mese. Nessun addebito, nessuna carta di credito richiesta — è sufficiente per localizzare una piccola app o per valutare correttamente la qualità prima di impegnarsi.

Se hai bisogno di più della quota mensile gratuita, puoi acquistare un pacchetto per aumentare il tuo saldo caratteri. Utilizza l'indirizzo email associato all'ordine per accedere e usufruire dei vantaggi.

Pacchetti disponibili:

  • 100K Characters
    Prezzo: $4.90
    Traduci 100,000 caratteri.*
  • 1M Characters
    Prezzo: $14.90
    Traduci 1,000,000 caratteri.*
  • 5M Characters
    Prezzo: $39.90
    Traduci 5,000,000 caratteri.*

*Ogni pacchetto è valido per 90 giorni e il saldo rimanente viene riportato quando acquisti di nuovo prima che scada.

Confronta tutti i pacchetti e i prezzi

Cosa fare dopo

Scegli il prossimo passo che corrisponde a come intendi lavorare — o semplicemente traduci un file e vedi tu stesso il risultato.

Perché scegliere l10n.dev?

l10n.dev combina la potenza dell'IA con strumenti facili da usare per semplificare il tuo processo di localizzazione. Che tu sia uno sviluppatore o faccia parte di un team di localizzazione, la nostra piattaforma garantisce traduzioni accurate, efficienti e convenienti su misura per le tue esigenze.