Code-Kommentare übersetzen
Dieses Werkzeug übersetzt Kommentare und Docstrings innerhalb einer Quellcode-Datei in eine andere Sprache und lässt Funktionsnamen, Variablen, Syntax und Logik unverändert. Gedacht für Entwicklerteams, die internen, auf Deutsch kommentierten Code für ein internationales Team oder ein offenes Projekt zugänglich machen wollen.
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 erkannt und übersetzt wird
Zeilenkommentare, Blockkommentare und Docstrings werden anhand der jeweiligen Sprachsyntax erkannt, etwa doppelte Schrägstriche, Rautenzeichen oder dreifache Anführungszeichen, je nach Programmiersprache. Übersetzt wird ausschließlich der Text innerhalb dieser Kommentare; Funktionsnamen, Variablennamen, Zeichenketten im eigentlichen Programmcode und die Einrückung bleiben unverändert, sodass die Datei nach der Übersetzung weiterhin fehlerfrei kompiliert oder ausgeführt werden kann. Auch Zeichenketten, die im Programmcode selbst als Text ausgegeben werden, bleiben unangetastet.
Codebeispiele innerhalb von Kommentaren
Enthält ein Docstring ein kurzes Codebeispiel, etwa einen Beispielaufruf einer Funktion, bleibt dieses Beispiel unverändert stehen, während der erklärende Text davor und danach übersetzt wird. Diese Unterscheidung folgt derselben Logik wie bei der Markdown-Übersetzung, bei der Codeblöcke ebenfalls von der Übersetzung ausgenommen sind. So bleibt eine Dokumentation aus Text und Beispielcode auch nach der Übersetzung technisch korrekt und unmittelbar nachvollziehbar.
Preis
$0.003 pro Anfrage plus $0.0135 je 1.000 Wörter des Kommentartextes, ohne den eigentlichen Code. Eine Datei mit vielen Funktionen, aber wenigen Kommentaren, kostet entsprechend wenig; eine ausführlich dokumentierte Bibliothek mit langen Docstrings entsprechend mehr. Der Betrag richtet sich also nach der Menge an Erklärtext, nicht nach der Zeilenzahl des Codes insgesamt. Der genaue Betrag wird vor dem Absenden angezeigt, ohne Abonnement und ohne Mindestbestellwert je Datei.
Nutzung
Die Quellcode-Datei wird auf dieser Seite eingefügt oder hochgeladen und mit übersetzten Kommentaren zurückgegeben, oder über die API in eine bestehende Build- oder Dokumentationskette eingebunden, etwa vor der Veröffentlichung eines internen Projekts als offenes Projekt. Diese Fähigkeit befindet sich in der Beta-Phase und wird bei seltenen Kommentarformaten weiter verfeinert. Für README-Dateien und separate Dokumentationsseiten eignet sich das Schwesterwerkzeug für Markdown-Übersetzung.
Anwendungsfälle
Das interne Projekt wird zum offenen Projekt
Ein Entwicklerteam von Schneider IT-Systeme GmbH & Co. KG übersetzt die deutschen Kommentare eines internen Projekts ins Englische, bevor der Quellcode als offenes Projekt veröffentlicht wird.
Die Übergabe an ein Entwicklerteam in Polen
Vor der Übergabe eines Moduls an ein Entwicklerteam in Polen lässt Jonas Weber die deutschen Codekommentare ins Englische übersetzen, damit die Logik ohne Rückfragen nachvollziehbar bleibt.
Die Bibliothek mit ausführlichen Docstrings
Lukas Fischer übersetzt die Docstrings einer selbst geschriebenen Bibliothek ins Englische, damit sie sich in der internationalen Paketverwaltung verständlich veröffentlichen lässt.
Häufige Fragen
Wird der eigentliche Code verändert?
Nein, Funktionsnamen, Variablen, Zeichenketten im Programmcode und die Einrückung bleiben unverändert; übersetzt werden ausschließlich Kommentare und Docstrings.
Erkennt das Werkzeug verschiedene Programmiersprachen?
Ja, die gängigen Kommentar- und Docstring-Formate mehrerer verbreiteter Programmiersprachen werden erkannt.
Was passiert mit Codebeispielen innerhalb eines Docstrings?
Sie bleiben unverändert stehen, nur der erklärende Text davor und danach wird übersetzt.
Was kostet die Übersetzung von Codekommentaren?
$0.003 pro Anfrage plus $0.0135 je 1.000 Wörter Kommentartext, ohne den eigentlichen Code.
Wird die hochgeladene Datei gespeichert?
Nein, sie wird zur Übersetzung verarbeitet und danach nicht aufbewahrt; ein Konto ist nicht erforderlich.
Ist diese Funktion schon ausgereift?
Sie befindet sich in der Beta-Phase und wird bei seltenen oder unüblichen Kommentarformaten weiter verfeinert.
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/code-comments \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/code-comments", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/code-comments",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/code-comments", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/code-comments", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"text": "…"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.code_comments",
"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. |