Convertir HTML a PDF
Envíenos su HTML — un documento completo, una plantilla de factura, un reporte ya renderizado — y reciba un PDF idéntico a la página que dibujaría un navegador moderno. La API HTML a PDF aplica el mismo diseño, las mismas fuentes y el mismo CSS con los que ya trabaja, así que lo que ve en la vista previa es lo que entrega. Es asíncrona por diseño: hace un POST, recibe un task_id y el archivo terminado llega a su webhook o a un enlace firmado.
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 que de verdad resuelve
Todo equipo que factura, reporta o emite recibos termina necesitando un PDF, y casi todos recurren a un navegador headless que deben instalar, parchar, aislar y escalar. Eso significa fuentes que desaparecen en el servidor, un Chromium que devora memoria y una tubería que nadie quiere mantener. Este endpoint la elimina: sigue diseñando con el HTML y el CSS que su equipo ya conoce, y nosotros ponemos el motor de renderizado, las fuentes y la concurrencia. Su plantilla de factura sigue siendo una plantilla, no infraestructura frágil.
Cómo se comporta una solicitud
Hace un POST a /pdf/from-html con su marcado, su CSS opcional, el tamaño de página y los márgenes. Como renderizar un documento rico implica trabajo real, la llamada es asíncrona: devuelve de inmediato un task_id en lugar de bloquear su hilo. Cuando el PDF está listo le avisamos por webhook firmado — la vía recomendada — o lo descarga desde un enlace firmado válido 24 horas. El resultado es un PDF estándar, con el mismo modelo de caja, los mismos saltos y las mismas fuentes web de un navegador.
Por qué el HTML se volvió el lenguaje de maquetación para impresión
El PDF es el estándar de maquetación fija desde los años noventa, pero casi nadie lo escribe a mano. El HTML y el CSS, en cambio, desarrollaron un vocabulario real para impresión: reglas @page, control de saltos y medios paginados que dejan que una hoja de estilos describa tanto la pantalla como la hoja impresa. Esa convergencia hace natural generar PDFs desde HTML: no aprende un segundo formato, reutiliza el que ya habla su front end. Mientras más se parezca su plantilla a marcado real, más fiel es la salida.
Cómo encaja en su automatización
Como cada trabajo devuelve un task_id y avisa por webhook al terminar, la API HTML a PDF se integra en colas, tareas programadas y flujos por eventos, sin consultas repetidas. Dispare mil estados de cuenta al cierre de mes y deje que cada evento active el siguiente paso: archivar, enviar o firmar. Los errores nunca le cuestan en silencio: una tarea que falla se reintenta tres veces y luego devuelve un error claro. Solo paga por las páginas generadas.
Acceso, precio y qué pasa con sus datos
El precio es público y simple: $0.040 por solicitud más $0.001 por página, así que un reporte de diez páginas cuesta cinco centavos y puede prever un lote. El acceso requiere saldo prepago; sin saldo la solicitud devuelve un 402, y eso mantiene el servicio rápido y libre de abuso. Su HTML y el PDF viven solo durante la ventana de retención, luego se eliminan y jamás se usan para entrenar nada.
Qué puede hacer con ella
Facturas y recibos a gran escala
Renderice cada confirmación de pedido o factura mensual desde la misma plantilla HTML que ve en la aplicación, de modo que la copia contable, la del cliente y el registro archivado sean idénticas. Dispare una llamada por pedido y adjunte el PDF a su correo transaccional.
Reportes y estados de cuenta programados
Convierta tableros, resúmenes analíticos o estados de cuenta en PDFs imprimibles con una tarea nocturna, con saltos de página reales y encabezados repetidos en vez de una captura de pantalla. Cada webhook de finalización puede entregar el archivo directo a su paso de envío o archivado.
Certificados, boletos y etiquetas
Genere certificados de cursos, boletos de evento con códigos únicos o etiquetas de envío inyectando datos en un diseño HTML con estilo, y produzca un PDF listo para imprimir en el tamaño de página exacto que espera la impresora.
Contratos y documentación generada
Arme acuerdos o cotizaciones a partir de HTML dinámico, congélelos en un PDF de maquetación fija para firma y guarde el documento aprobado: el mismo marcado que edita su equipo legal se convierte en el archivo que recibe el cliente.
Preguntas frecuentes
¿Cómo convierto HTML a PDF con una API?
Haga un POST de su marcado a /pdf/from-html y recibe un task_id. Cuando el PDF está listo llega a su webhook o a un enlace firmado, así que una sola llamada le lleva del HTML al archivo terminado.
¿Hay un plan gratuito o una prueba 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.
¿Cuánto cuesta por PDF?
Paga $0.040 por solicitud más $0.001 por página, así que un documento de cinco páginas cuesta $0.045. Una tarea que falla tras sus reintentos nunca se cobra.
¿Se renderizan bien mi CSS y mis fuentes web?
Sí: el endpoint usa el mismo modelo de caja, las mismas reglas de salto de página y el mismo manejo de fuentes web que aplica un navegador moderno, así que una plantilla que se ve bien en la vista previa se ve bien en el PDF. Use CSS de @page y medios paginados para controlar tamaño, márgenes y saltos.
¿Por qué la API es asíncrona en vez de devolver el PDF directamente?
Renderizar un documento rico es trabajo real, así que bloquear una conexión mientras se pintan las páginas es frágil a gran escala. Devolver un task_id y entregar por webhook mantiene su solicitud rápida y le deja generar lotes grandes sin timeouts.
¿Puedo generar PDFs de forma masiva?
Sí. Como cada trabajo es independiente y avisa de su finalización por webhook, puede disparar miles de documentos a la vez y reaccionar a cada archivo terminado conforme llega su evento, sin consultas repetidas.
¿Cuánto tiempo está disponible el resultado y guardan mis datos?
Un enlace firmado sigue válido durante 24 horas, que también es una buena ventana para que su webhook guarde el archivo. Tras la ventana de retención, su HTML y su PDF se eliminan y nunca se usan para entrenar nada.
¿Qué pasa si una conversión falla?
Una tarea que no puede completarse se reintenta hasta tres veces con espera creciente, y solo entonces devuelve un error claro. Nunca se le cobra una conversión fallida: solo paga por las páginas que realmente se producen.
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/pdf/from-html \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"html":"<h1>Factura 001</h1><p>Total: 100 EUR</p>"}'const res = await fetch("https://api.kit.forhosting.com/pdf/from-html", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"html": "<h1>Factura 001</h1><p>Total: 100 EUR</p>"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/from-html",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"html": "<h1>Factura 001</h1><p>Total: 100 EUR</p>"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/from-html", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"html":"<h1>Factura 001</h1><p>Total: 100 EUR</p>"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"html":"<h1>Factura 001</h1><p>Total: 100 EUR</p>"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/from-html", 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
{
"html": "<h1>Factura 001</h1><p>Total: 100 EUR</p>"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.from_html",
"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_mb | 25 |
max_pages | 200 |
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. |