Traducir un Word
Un Word traducido que regresa como texto plano no es un documento traducido, es un trabajo de reconstrucción pendiente. Este endpoint conserva los estilos, los niveles de encabezado y las tablas donde estaban, para que el documento que reciba siga siendo editable y no una copia que hay que rearmar desde cero.
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.
Por qué el formato .docx en sí es la parte difícil
Un archivo DOCX no es realmente un documento; es un pequeño archivo comprimido de partes XML que describen fragmentos de texto, referencias de estilo, tablas y saltos de sección enlazados entre sí. Traducir las palabras visibles sin respetar esa estructura produce un archivo que abre con numeración rota, estilos que ya no aplican o una tabla donde tres celdas desaparecieron sin aviso. Cualquiera que maneje plantillas de propuestas, guías de estilo apoyadas en jerarquías de Título 1/Título 2 o contratos con cláusulas numeradas sabe exactamente cuánto vale esa estructura y lo molesto que es perderla.
Qué hace el endpoint
Envíe POST a /translate/docx con el archivo de origen y el idioma destino, y devuelve un task_id de inmediato mientras la traducción corre en segundo plano, el mismo patrón asíncrono usado en toda la API, para que los documentos largos no bloqueen una conexión. Recorre la estructura propia del documento y traduce el texto del cuerpo párrafo por párrafo —agrupando los fragmentos de cada párrafo para no partir una frase por la mitad—, dejando intactas las referencias de estilo, la disposición de las tablas, la numeración y los saltos de sección. Los estilos de párrafo, las tablas y la numeración regresan tal cual estaban; la contrapartida de traducir el párrafo entero es que el formato de carácter que partía una misma frase en varios fragmentos puede unificarse. Recibe un .docx que abre sin problemas en cualquier procesador de texto estándar con el formato conservado.
Dónde encaja junto a la traducción de PDF
El PDF es una fotografía fija, fiel a la impresión: correcta para un contrato firmado o un formulario archivado que nunca debe cambiar. El DOCX es lo opuesto: está pensado para seguir editándose, revisarse con control de cambios y reutilizarse como plantilla. Traducir un DOCX y recibir otro DOCX importa justamente por eso: una propuesta traducida, un borrador de contrato o una política interna que alguien todavía necesita revisar, comentar o fusionar con lenguaje legal local después de la traducción, no solo leer.
Cómo encaja con el resto de la API
Se cobra a $0.057 por solicitud más $0.016 por página, y usa el mismo patrón de task_id, webhook y enlace firmado válido por 24 horas que el resto de la API, así que las integraciones que ya llaman a otros endpoints de traducción no necesitan infraestructura nueva: solo apúntelas a /translate/docx y encaja en el flujo que ya maneja la traducción de documentos. Los archivos de origen y los traducidos se eliminan tras el período de retención y nunca se usan para entrenar modelos.
Qué puede hacer con ella
Plantillas de propuestas para nuevos mercados
Un equipo comercial traduce su plantilla de propuestas en Word al idioma de un nuevo mercado, conservando encabezados, tablas y estilos de marca para reutilizarla.
Borradores de contratos editables
Un equipo legal obtiene un contrato traducido que se abre como DOCX editable, para que el equipo local pueda agregar cláusulas con control de cambios después de la traducción.
Documentos internos de políticas
Un área de recursos humanos traduce manuales de políticas con varias secciones numeradas y conserva esa numeración en cada versión de idioma.
Flujos de documentación bilingüe
Una empresa de software pasa sus notas de versión en Word por traducción automática como parte del proceso de generación de documentación.
Preguntas frecuentes
¿Cómo traduzco un documento de Word con la API?
Envíe el archivo DOCX y el idioma destino por POST a /translate/docx, guarde el task_id devuelto y reciba el DOCX traducido por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para traducir Word?
No, no hay plan gratuito ni prueba; el precio es $0.057 por solicitud más $0.016 por página, y una traducción fallida nunca se cobra.
¿El DOCX traducido sigue siendo editable?
Sí, ese es el objetivo del endpoint: trabaja a nivel de la estructura del documento para que estilos, encabezados y tablas queden intactos y editables, sin aplanar el texto.
¿Ya está en producción /translate/docx?
Sí, ya está disponible y acepta trabajos, tanto desde esta página como por la API, con el mismo patrón de task_id y webhook que los demás endpoints de traducción.
¿Conserva tablas y encabezados numerados?
Sí, traduce el texto del cuerpo párrafo por párrafo dejando intactas la disposición de las tablas y los estilos de encabezado, así que la numeración y la estructura se mantienen.
¿Cómo se calcula el precio?
Es una tarifa fija por solicitud más una tarifa por página según la extensión del documento, el mismo modelo predecible que usan los demás endpoints de traducción.
¿Puedo traducir muchos archivos de Word por lote?
Sí, una tarea asíncrona por archivo con resultados recibidos por webhook, igual que funcionan los lotes en el resto de la API.
¿Se guarda mi documento de Word después de traducirlo?
No, los archivos de origen y los traducidos se eliminan después del período de retención y nunca se usan para entrenar modelos.
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, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/translate/docx \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"file":"https://ejemplo.com/documento.docx","target_lang":"en"}'const res = await fetch("https://api.kit.forhosting.com/translate/docx", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"file": "https://ejemplo.com/documento.docx",
"target_lang": "en"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/docx",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"file": "https://ejemplo.com/documento.docx",
"target_lang": "en"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/docx", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"file":"https://ejemplo.com/documento.docx","target_lang":"en"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"file":"https://ejemplo.com/documento.docx","target_lang":"en"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/docx", 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
{
"file": "https://ejemplo.com/documento.docx",
"target_lang": "en"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.docx",
"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. |
413 | input_too_large | El archivo supera el límite de tamaño. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |