JSON-Datei übersetzen
Dieses Werkzeug übersetzt die Werte einer JSON-Datei – etwa eine Sprachdatei einer App oder Website – in eine andere Sprache und lässt Schlüssel, Verschachtelung und Datentypen unangetastet. Gedacht für Entwicklerinnen und Entwickler, die eine Ressourcendatei um eine weitere Sprache ergänzen, ohne jeden Eintrag von Hand zu übertragen.
Online ausführen
Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.
Was übersetzt wird
Übersetzt werden ausschließlich Werte vom Typ Zeichenkette; Zahlen, Boolesche Werte, Arrays mit technischen Codes und die Schlüssel selbst bleiben unverändert. Der Schlüssel welcome_message bleibt exakt gleich, nur sein Wert wechselt von Hallo zu Hello. Die Struktur der Datei bleibt dabei Zeichen für Zeichen erhalten, sodass sie sich ohne Anpassung wieder in dieselbe Anwendung laden lässt. Ein Array mit technischen Codes, etwa Ländercodes oder Statuswerten, wird als solches erkannt und ebenfalls nicht angerührt.
Platzhalter bleiben stehen
Platzhalter innerhalb eines Wertes, etwa {name} oder %s, werden erkannt und unverändert an derselben Stelle im übersetzten Text belassen, damit eine Anwendung, die zur Laufzeit Werte einsetzt, nicht bricht. Eine einzelne Fett- oder Kursiv-Auszeichnung innerhalb eines Wertes wird ebenso respektiert wie in einer reinen HTML-Datei, sodass keine Formatierung verloren geht. Auch Zeilenumbrüche innerhalb eines mehrzeiligen Wertes bleiben an derselben Stelle stehen, statt beim Übersetzen zu verrutschen.
Preis
$0.003 pro Anfrage plus $0.0135 je übersetztem Schlüssel. Eine Sprachdatei mit 200 Einträgen kostet damit rund $2,70 zuzüglich der Grundgebühr – deutlich weniger als die gleiche Arbeit von Hand. Leere oder rein technische Werte, die nicht übersetzt werden müssen, lassen sich vorab aus der Datei entfernen, um die Kosten zu senken. Der genaue Betrag wird vor dem Absenden angezeigt, abhängig von der Anzahl der tatsächlich übersetzten Zeichenketten-Werte in der Datei.
Nutzung
Die Datei wird auf dieser Seite hochgeladen oder eingefügt und als vollständige JSON-Datei zurückgegeben, oder über die API in eine bestehende Build-Pipeline eingebunden, etwa um bei jedem Release automatisch eine neue Sprache zu ergänzen. Für HTML-Dateien oder reinen Fließtext eignen sich die jeweiligen Schwesterwerkzeuge besser als das Einfügen von strukturierten Daten. Bei einer mehrsprachigen App lässt sich derselbe Ablauf für jede weitere Zielsprache mit einer eigenen Anfrage wiederholen.
Anwendungsfälle
Die App-Sprachdatei um Französisch ergänzen
Ein Entwicklerteam bei Schneider IT-Systeme GmbH & Co. KG ergänzt die bestehende Ressourcendatei einer internen App um eine französische Fassung, ohne jeden der rund 150 Einträge von Hand zu übersetzen.
Die Website-Texte um eine neue Sprache erweitern
Vor dem Start in den Niederlanden lässt Lukas Fischer die JSON-Datei mit den Oberflächentexten seiner Website übersetzen und bindet sie unmittelbar in die bestehende Struktur ein.
Fehlermeldungen einer Schnittstelle konsistent übersetzen
Ein Backend-Team übersetzt die JSON-Datei mit den Fehlermeldungen einer internen Schnittstelle, damit Nutzer in mehreren Ländern dieselbe Meldung in ihrer eigenen Sprache sehen.
Häufige Fragen
Bleiben die Schlüssel garantiert unverändert?
Ja, nur die Werte vom Typ Zeichenkette werden übersetzt; Schlüssel, Zahlen, Boolesche Werte und die Struktur der Datei bleiben exakt erhalten.
Was passiert mit Platzhaltern wie {name}?
Sie werden erkannt und unverändert an derselben Stelle im übersetzten Wert belassen, damit eine Anwendung sie weiterhin korrekt einsetzen kann.
Wie wird der Preis pro Schlüssel berechnet?
$0.003 pro Anfrage plus $0.0135 je übersetztem Schlüssel mit Zeichenketten-Wert; leere oder rein technische Werte zählen nicht mit.
Wird die hochgeladene Datei gespeichert?
Nein, sie wird zur Übersetzung verarbeitet und danach nicht aufbewahrt; ein Konto, in dem Dateien abgelegt würden, ist nicht erforderlich.
Wie viele Schlüssel lassen sich auf einmal übersetzen?
Rund 20.000 Token pro Anfrage; für sehr umfangreiche Sprachdateien lässt sich die Übersetzung in mehreren Anfragen aufteilen.
Funktioniert das auch mit verschachtelten JSON-Strukturen?
Ja, auch mehrfach verschachtelte Objekte und Arrays werden korrekt durchlaufen, ohne dass sich die Struktur der Datei verändert.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"input": "…"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.json",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_tokens | 20000 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
422 | task_failed | Die Aufgabe ist fehlgeschlagen und wird nicht berechnet. |