Traducir un PDF
Un contrato, un manual o un formulario oficial casi nunca llega como texto plano: llega como PDF, con columnas, tablas y un bloque de firmas que debe quedar exactamente donde estaba. Este endpoint lee el documento, traduce las palabras y reconstruye la página en lugar de devolverle un bloque de texto sin formato.
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 problema de 'copiar y pegar en un traductor'
Copie el texto de un PDF a dos columnas y péguelo en cualquier otro lugar: las columnas se colapsan, las notas al pie saltan al lugar equivocado y la tabla que alineaba precios con fechas termina convertida en una oración continua. Eso sirve para una lectura rápida, pero es inútil para un documento que alguien necesita archivar, imprimir o firmar. Departamentos legales, áreas de recursos humanos que contratan personal extranjero y operaciones de comercio exterior con papeleo aduanero chocan con el mismo obstáculo: la traducción es solo la mitad del trabajo si el diseño no sobrevive.
Qué ocurre realmente con el archivo
Envíe POST a /translate/pdf con el archivo de origen y el idioma destino, y recibirá un task_id de inmediato; el documento entra en cola, su texto se extrae página por página, se traduce y se coloca de nuevo dentro de la estructura original: mismos saltos de página, mismas tablas, misma posición aproximada de encabezados y figuras. Como todo corre de forma asíncrona, un contrato de arrendamiento de diez páginas y una factura de dos páginas entran en cola igual, y usted nunca queda esperando con una conexión abierta a que termine una traducción lenta.
Por qué traducir PDF es más difícil de lo que parece
El formato PDF se diseñó a inicios de los años noventa como un formato fijo, fiel a la impresión: describe dónde cae la tinta en la página, no qué significan las palabras a nivel estructural como sí lo hace un documento HTML. Por eso mismo se volvió el estándar para todo lo que debe verse idéntico en cualquier lugar: contratos, certificados, artículos académicos. Pero también significa que traducir a partir de un PDF exige primero reconstruir el orden lógico de lectura -qué texto pertenece a qué párrafo, qué celda pertenece a qué tabla- antes de traducir una sola palabra, porque de lo contrario una oración dividida por un salto de página sale mezclada.
Cómo recibe el resultado y dónde encaja
Cuando la traducción termina, el nuevo PDF llega mediante una llamada de webhook firmada, o queda disponible en un enlace firmado válido por 24 horas si su sistema prefiere consultar en lugar de recibir el aviso. Como el precio es una tarifa fija por solicitud más una tarifa por página, un acuerdo de confidencialidad de cinco páginas y un manual técnico de cincuenta páginas cuestan exactamente lo que predice su número de páginas, sin sorpresas ni redondeos a un plan. Intégrelo en un flujo de incorporación de personal, un gestor documental o un proceso nocturno que limpia un rezago de traducciones, y se convierte en un paso confiable más, no en una tarea manual que nadie quiere hacer.
Qué puede hacer con ella
Contratos laborales internacionales
Una plataforma de recursos humanos traduce contratos de trabajo firmados al idioma del nuevo empleado, conservando la numeración de cláusulas y la posición de las firmas.
Papeleo aduanero y de envíos
Una empresa de logística traduce facturas de proveedores y certificados de origen para que los agentes aduanales del país destino los lean sin necesidad de reformatearlos.
Distribución de artículos académicos
Una oficina de investigación traduce artículos publicados en PDF para circulación interna sin romper el formato de citas ni la posición de las figuras.
Revisión de expedientes regulatorios
Un equipo de cumplimiento traduce PDF de reguladores extranjeros a su idioma de trabajo para que el equipo legal revise cada cláusula junto a la estructura original.
Preguntas frecuentes
¿Cómo traduzco un PDF con la API?
Envíe el archivo PDF y el idioma destino por POST a /translate/pdf, guarde el task_id devuelto y reciba el PDF traducido por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para traducir PDF?
No, no hay plan gratuito ni prueba; cuesta $0.011 por solicitud más $0.0705 por página, y una traducción fallida nunca se cobra.
¿El PDF traducido conserva el diseño original?
Sí, el endpoint reconstruye la estructura de la página -tablas, columnas y saltos de página- alrededor del texto traducido en lugar de devolver texto plano.
¿Funciona con PDF escaneados o solo con texto?
Está diseñado para PDF con texto extraíble; las páginas que son solo imágenes escaneadas conviene procesarlas primero con OCR para obtener resultados confiables.
¿Cómo se calcula el precio en un documento largo?
El precio es una tarifa fija por solicitud más una tarifa por página, así que un manual de 100 páginas cuesta más que una carta de 2 páginas de forma predecible, sin planes por niveles.
¿Puedo traducir muchos PDF por lote?
Sí, envíe una tarea asíncrona por archivo y reciba cada PDF terminado por webhook a medida que se completa, que es el patrón normal para lotes de documentos.
¿Ya está disponible este endpoint?
Sí, /translate/pdf está en producción y acepta solicitudes desde ahora.
¿Se guarda mi documento 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 ningún modelo.
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/pdf \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/pdf", {
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/pdf",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/pdf", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/pdf", 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.pdf",
"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. |