Traduci un file JSON
Se localizzi un’app o un sito, i testi stanno in un file JSON di coppie chiave-valore. Questo strumento traduce solo i valori — il testo che l’utente vede — e lascia intatte le chiavi e i segnaposto. Carichi il file, scegli la lingua e riottieni un JSON valido, pronto per la produzione.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Le chiavi non si toccano
In un file di localizzazione la chiave ("button.save") è un identificatore che il codice cerca per nome: se cambia, l’app si rompe. Qui viene tradotto solo il valore ("Salva" → "Save"), mentre chiavi, annidamenti e ordine restano identici. Il file che riottieni ha la stessa forma dell’originale: lo confronti a colpo d’occhio e non devi rimettere a posto niente.
Segnaposto e variabili al sicuro
I testi delle app sono pieni di segnaposto come {count} messaggi o %s, e a volte di frammenti HTML per il grassetto. Questi elementi restano intatti nella nuova lingua e finiscono nella posizione giusta della frase: se in italiano scrivi “Hai {count} nuovi messaggi”, in inglese ottieni “You have {count} new messages”, con la variabile al posto corretto. Le stringhe con plurali vengono gestite come tali, non tradotte a caso.
Un file, tutte le lingue
Parti dal tuo it.json e generi en.json, de.json, fr.json una lingua alla volta, tenendo le chiavi allineate tra i file. Il costo si conta a chiave tradotta, quindi sai già in anticipo quanto ti costa un file di 400 stringhe. Il limite pratico è di circa 20.000 token per richiesta: un file molto grande si divide in blocchi.
Casi d'uso
L’app da pubblicare in inglese
Alessandro Ferrari sta per pubblicare un’app gestionale e ha it.json con 300 stringhe. Genera en.json in un colpo: le chiavi restano quelle che il codice si aspetta, cambia solo il testo mostrato.
Il sito in tre lingue
Rossi & Figli S.r.l. tiene i testi del sito in file JSON. Per aprire ai mercati tedesco e francese traduce i valori mantenendo i segnaposto dei prezzi e delle quantità intatti.
Le nuove stringhe di ogni rilascio
A ogni versione Luca Esposito aggiunge una manciata di chiavi nuove. Traduce solo il blocco aggiornato e lo reincolla nel file della lingua, senza rifare tutta la localizzazione.
Domande frequenti
Il file che riottengo è ancora JSON valido?
Sì: la struttura, le virgolette, gli annidamenti e la formattazione restano corretti. Puoi metterlo in produzione o passarlo allo strumento di validazione JSON per una controprova.
Cosa succede ai segnaposto come {name} o %s?
Restano intatti e vengono spostati nella posizione giusta della frase tradotta. Non vengono tradotti né cancellati, così le variabili continuano a funzionare nell’app.
Posso tradurre solo alcune chiavi?
Sì: puoi passare solo il blocco di stringhe nuove o modificate e reincollarlo nel file della lingua di destinazione, senza rielaborare l’intero file.
Come viene calcolato il prezzo?
$0.003 a richiesta più $0.0135 a chiave tradotta. Un file da 200 stringhe costa poco più di due dollari e mezzo, e sai il conto prima di partire perché dipende dal numero di chiavi.
C’è un limite di dimensione del file?
Circa 20.000 token per richiesta. Un file di localizzazione molto grande va diviso in più blocchi e tradotto a pezzi, poi ricomposto.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/translate/json \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/json", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/json",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/json", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/json", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"input": "…"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.json",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_tokens | 20000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
422 | task_failed | L'attività non è andata a buon fine: non ti viene addebitato nulla. |