Traduire les commentaires d’un code
Cet outil traduit les commentaires et la documentation d’un code source vers une autre langue, sans modifier une ligne de code exécutable. Il vise les équipes qui partagent un projet entre plusieurs langues et veulent des explications lisibles par tous, sans risquer de casser le programme. La fonction est en bêta.
Exécuter en ligne
Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.
Les commentaires traduits, le code intact
L’outil distingue le code des commentaires : seules les explications — commentaires de ligne, blocs de documentation, textes d’aide — sont traduites. Les noms de variables, les fonctions, la syntaxe et la logique ne sont pas touchés. Le programme se comporte exactement pareil après traduction ; seule la partie destinée aux humains change de langue, ce qui aide un développeur étranger à reprendre le projet plus vite.
Une fonction en bêta
Repérer précisément ce qui est un commentaire et ce qui n’en est pas varie selon les langages, et certains cas limites restent délicats. La fonction est donc en bêta : relisez le résultat, surtout si un commentaire contient lui-même des bouts de code ou des exemples. Nous ne prétendons pas gérer parfaitement tous les langages ; nous préférons annoncer la limite plutôt que la taire.
Prix et volume
Facturation à l’usage, sans abonnement ni compte : $0.003 par requête, puis $0.0135 pour 1 000 mots de commentaires, le code n’étant jamais compté dans le décompte. Un fichier revient à quelques centimes. Le montant s’affiche avant de lancer et dépend du volume de commentaires. Comptez environ 15 000 mots par envoi, et traitez les gros projets fichier par fichier.
Cas d’usage
Ouvrir un projet à une équipe internationale
Une petite équipe a commenté son code en français. Pour intégrer un développeur anglophone, les commentaires sont traduits en anglais, sans que le code ne change d’un caractère.
Documenter un composant partagé
Studio Lumen SAS partage une bibliothèque interne. Les blocs de documentation sont traduits en anglais pour un partenaire, les signatures de fonctions restant identiques.
Comprendre un code hérité
Un projet racheté est commenté en allemand. Traduire les commentaires en français aide l’équipe à reprendre la main sans deviner l’intention derrière chaque fonction.
Questions fréquentes
Le code lui-même est-il modifié ?
Non. Seuls les commentaires et la documentation sont traduits. Les noms de variables, les fonctions et la syntaxe restent intacts : le programme se comporte à l’identique.
Quels types de commentaires sont pris en charge ?
Les commentaires de ligne, les blocs de commentaires et les chaînes de documentation. La reconnaissance dépend du langage ; c’est aussi pour cela que la fonction est encore en bêta.
Pourquoi la fonction est-elle en bêta ?
Parce que distinguer commentaire et code comporte des cas limites, surtout quand un commentaire contient lui-même des exemples de code. Une relecture rapide reste conseillée.
Combien cela coûte-t-il ?
En dollars : $0.003 par requête et $0.0135 pour 1 000 mots de commentaires, le code non compté. Le prix s’affiche avant de lancer.
Mon code est-il conservé après traitement ?
Non. Le fichier sert à traduire les commentaires puis est supprimé, l’échange étant chiffré. Rien n’est gardé ni réutilisé.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"text": "…"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.code_comments",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_tokens | 20000 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
422 | task_failed | La tâche a échoué : elle ne vous est pas facturée. |