Traducir comentarios de código
Un repositorio heredado de un equipo que comentaba en otro idioma resulta ilegible para cualquiera nuevo hasta que alguien traduce los comentarios, pero pasar el archivo por un traductor genérico arriesga que toque un literal de texto o el nombre de una variable, algo que nunca debería suceder. El endpoint de Traducción de Comentarios de Código analiza el archivo, traduce solo lo que realmente es un comentario o docstring, y devuelve el código idéntico byte por byte en todo lo demás.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El fallo específico que evita
Los traductores de texto genéricos no distinguen entre un comentario y una cadena de la que depende el programa en tiempo de ejecución, y un traductor que modifica el texto de un mensaje de log, un patrón de expresión regular o una variable nombrada en portugués puede romper una compilación de forma silenciosa y muy difícil de rastrear. Los equipos que adquieren una base de código, integran desarrolladores externos, o fusionan dos equipos de ingeniería que programaron en idiomas distintos se topan exactamente con este problema: hay que traducir los comentarios, y nada más en el archivo puede cambiar.
Cómo identifica qué traducir
El endpoint analiza el código fuente enviado según su sintaxis de comentarios, ya sea un comentario de línea con doble barra, un comentario de bloque, un docstring o una anotación en línea, y traduce únicamente el texto que vive dentro de esas construcciones. El código, los literales de texto, los identificadores y el formato fuera de los comentarios pasan sin tocarse; el archivo devuelto coincide estructuralmente con el original, con solo el texto de los comentarios cambiado al idioma destino.
Dónde encaja en la integración de equipos y las auditorías
El idioma de los comentarios ha reflejado silenciosamente la composición del equipo de ingeniería desde que el software se subcontrata o se adquiere entre países; un repositorio con comentarios en un idioma y un equipo nuevo que lee otro es lo bastante común como para que la mayoría de líderes de ingeniería lo hayan vivido al menos una vez. En vez de pagarle a un desarrollador para traducir comentario por comentario a mano, o peor, dejarlos como están y esperar que el nuevo personal se las arregle, este endpoint convierte eso en un solo trabajo enviado por archivo o por exportación de repositorio.
Ejecutarlo en todo un repositorio
Envía archivos individualmente o programa un lote sobre la exportación completa de un repositorio; cada llamada corre de forma asíncrona y devuelve un task_id, con el archivo traducido entregado por webhook firmado o por un enlace firmado válido por 24 horas. Al ser una API, encaja tanto en un script de migración de una sola vez como en un paso de integración continua que marca comentarios nuevos en el idioma equivocado antes de aprobar un merge.
Lo que todavía necesita ojo de desarrollador
La jerga específica del dominio y las abreviaturas que el autor original inventó como taquigrafía para su propio equipo pueden no traducirse con limpieza, y un desarrollador familiarizado con el código debería revisar el resultado antes de fusionarlo, la misma revisión que merece cualquier texto técnico traducido. Lo que este endpoint garantiza es la parte que más importa para la seguridad: bajo ninguna circunstancia va a alterar el código ejecutable en sí.
Qué puede hacer con ella
Integración de una base de código adquirida
Una empresa que adquiere una startup cuyo código está comentado en otro idioma traduce todo el repositorio para que su nuevo equipo de ingeniería entienda el razonamiento detrás del código sin un mediador bilingüe.
Entrega de un equipo externo
Un equipo distribuido fusiona un módulo escrito por desarrolladores que comentaron en su idioma nativo, traduciendo los comentarios antes de la revisión de código para que cada revisor entienda la intención.
Preparación para abrir el código como open source
Un mantenedor que prepara un repositorio privado para publicarlo como open source traduce todos los comentarios internos al inglés para que los colaboradores internacionales entiendan el código a la primera lectura.
Verificación en CI antes del merge
Un equipo de ingeniería programa un paso de integración continua que traduce cualquier comentario recién agregado que no esté en el idioma estándar del proyecto, marcando el diff para revisión antes del merge.
Preguntas frecuentes
¿Va a modificar mi código real?
No, solo se traduce el texto dentro de sintaxis reconocida como comentario o docstring; el código, los literales de texto y los identificadores pasan sin cambios, byte por byte.
¿La API de traducción de comentarios de código es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Qué lenguajes de programación soporta?
Funciona con las sintaxis de comentario habituales de los lenguajes de programación más usados, incluyendo comentarios de línea, de bloque y docstrings; envía el archivo y su estilo de comentario se detecta durante el análisis.
¿Puedo ejecutarla sobre un repositorio completo, no solo un archivo?
Sí, envía archivos individualmente o programa un lote sobre un repositorio exportado; cada llamada corre de forma asíncrona con su propio task_id, así que muchos archivos pueden procesarse en paralelo.
¿Cómo recibo el archivo traducido?
Recibe un task_id de inmediato, y el archivo traducido se entrega por webhook firmado, el método recomendado para integrarlo en un pipeline, o por un enlace firmado válido por 24 horas.
¿Traduce literales de texto que parecen comentarios?
No, solo traduce el contenido dentro de sintaxis real de comentario o docstring según el análisis del archivo; los literales de texto que usa el programa en ejecución quedan intactos.
¿Qué pasa si un comentario falla al traducirse?
La tarea reintenta automáticamente hasta tres veces; si sigue sin poder completarse, recibe un error claro y no se le cobra el intento.
¿Mi código fuente se guarda o se usa para entrenar modelos?
No. El código enviado se procesa únicamente para generar su resultado y se elimina después del período de retención; nunca se usa para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su 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)Ejemplo de solicitud
{
"text": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.code_comments",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |