ForHosting KIT · Traducción y localización

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.

Retirada temporalmentePor solicitud + por página$0.057

Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.

Cómo funciona y API

Úselo desde WebAPIEmailApp prontoTelegram pronto

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é está diseñado para hacer 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. La idea es recorrer la estructura propia del documento: traducir cada fragmento de texto en su lugar, dejar intactas las referencias de estilo, la disposición de las tablas y los saltos de sección, y entregar un .docx que abra 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.

Estado actual y qué esperar

translate.docx está en despliegue: el precio quedó fijado en $0.057 por solicitud más $0.016 por página, y el endpoint todavía no acepta trabajos de producción. Cuando se habilite, aplicará el mismo patrón de task_id, webhook y enlace firmado válido por 24 horas que ya usa el resto de la API, así que las integraciones que ya llaman a otros endpoints de traducción no necesitarán infraestructura nueva: solo apuntar a /translate/docx cuando entre en producción y encajará en el flujo que ya maneja la traducción de documentos.

Qué puede hacer con ella

Plantillas de propuestas para nuevos mercados

Un equipo comercial planea traducir 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 quiere un contrato traducido que se abra 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 planea traducir manuales de políticas con varias secciones numeradas y conservar esa numeración en cada versión de idioma.

Flujos de documentación bilingüe

Una empresa de software planea pasar 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 traduciré un documento de Word con la API?

Enviará el archivo DOCX y el idioma destino por POST a /translate/docx, guardará el task_id devuelto y recibirá el DOCX traducido por webhook o mediante un enlace firmado válido por 24 horas, una vez que el endpoint esté habilitado.

¿Es gratis la API para traducir Word?

No, no hay plan gratuito ni prueba; el precio quedó fijado en $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?

Todavía no; está en despliegue y por el momento no acepta trabajos, así que conviene verificar el estado del endpoint antes de enviar tráfico de producción.

¿Va a conservar tablas y encabezados numerados?

Sí, el diseño traduce los fragmentos de texto 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.

¿Podré traducir muchos archivos de Word por lote?

Sí, el plan es 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 eliminarán 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

POSThttps://api.kit.forhosting.com/translate/docx

¿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/docx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

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({
    "input": "…"
  })
});
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[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
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" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
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

{
  "input": "…"
}

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

Por solicitud$0.057

Por página$0.016

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.

Ver la documentación completa del KIT →