Optimizar un PDF para web
Un PDF que necesita descargarse por completo antes de mostrar la primera página se siente roto en una conexión lenta, aunque el contenido esté perfecto. La API Optimizar PDF para Web reordena la estructura interna de bytes del documento para que un navegador o visor pueda pintar la primera página en cuanto llegan los datos suficientes, mientras el resto se transmite en segundo plano.
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.
La espera que esto resuelve en silencio
Abra un PDF grande directo desde un enlace con una conexión mediocre y seguramente ha visto el visor en blanco con un ícono de carga girando, aunque solo quería leer la primera página. Eso pasa porque la mayoría de los PDF se escriben pensando en acceso local, no en transmisión: la tabla de referencias cruzadas que le dice al visor dónde está cada cosa suele quedar al final del archivo, así que nada puede mostrarse hasta que llega todo. Linealizar reordena el archivo para que los objetos de la página uno, junto con una tabla de referencias compacta, queden al principio, permitiendo que el visor empiece a renderizar antes de que termine la descarga.
Dónde importa esto de verdad
Cualquiera que entregue PDF a un navegador en vez de a una app de escritorio lo siente directamente: catálogos en línea, visores incrustados en un sitio de documentación, portales de gobierno que publican expedientes públicos extensos, o una app móvil que muestra la vista previa de un adjunto antes de que el usuario decida descargarlo. Mientras más grande el archivo y más débil la conexión, más cambia una estructura linealizada la experiencia, de una pantalla congelada a una página legible de inmediato.
Qué pasa dentro de la petición
Envía su documento con un POST a /pdf/linearize y recibe un task_id de inmediato; reestructurar incluso un PDF de tamaño moderado es trabajo real y nunca debería mantener su petición abierta. El motor reescribe el orden interno de los objetos y los flujos de referencias cruzadas según el formato linealizado definido en la especificación del PDF, sin tocar un solo píxel visible del contenido. El resultado se entrega a su webhook firmado o a un enlace firmado válido por 24 horas, y abre, imprime y se ve exactamente igual al original, solo que más rápido en la primera página.
Una capacidad más vieja que la mayor parte de la web
La linealización, a veces llamada Fast Web View, forma parte de la especificación del PDF desde sus primeras versiones en los años noventa, pensada justo para las condiciones de dial-up y banda ancha temprana de esa época. Nunca salió de la especificación, pero la mayoría de las herramientas que generan PDF se saltan ese paso extra de optimización, dejando la capacidad sin usar. Este endpoint la aplica de forma deliberada y consistente, algo que hoy importa más que nunca dado cuánto de la lectura de PDF ocurre dentro de una pestaña del navegador y no como archivo descargado.
Cómo encaja en un flujo automatizado
Como el resultado se entrega de forma asíncrona y por webhook, la linealización encaja como un último paso justo antes de publicar: genere o reciba un documento, linealícelo y solo entonces envíelo al almacenamiento o red de distribución desde donde su sitio lo sirve. Una linealización fallida se reintenta tres veces y nunca se cobra si aun así no se completa, así que su flujo recibe un error claro en vez de un archivo silenciosamente roto. El acceso requiere saldo prepago, y el precio es fijo, $0.042 por petición más $0.0025 por documento. Nota: este endpoint está en despliegue final y comenzará a aceptar trabajos en breve.
Qué puede hacer con ella
Vista previa instantánea en un portal de documentación
Una empresa de software linealiza cada manual y referencia de API antes de publicarlos para que quien los lee en el navegador vea la primera página al instante, sin ícono de carga.
Publicación masiva de expedientes de gobierno
Una entidad pública procesa expedientes regulatorios extensos por el endpoint antes de publicarlos en línea, para que los ciudadanos con conexión lenta empiecen a leer la primera página sin descargar todo el archivo.
Vista previa de adjuntos en apps móviles
Una app de mensajería linealiza los PDF adjuntos del lado del servidor para que la vista previa de la primera página se muestre en el chat antes de que el usuario abra el documento completo.
Catálogos de productos en línea
Una tienda en línea linealiza su catálogo de temporada de varios cientos de páginas para que quien navega desde el móvil vea los productos de inmediato en vez de esperar una descarga de varios megabytes.
Preguntas frecuentes
¿Cómo optimizo un PDF para carga rápida en la web con una API?
Envíe un POST a /pdf/linearize con su archivo. La api optimizar pdf para web devuelve un task_id de inmediato y entrega el PDF reestructurado a su webhook o a un enlace firmado al terminar el proceso.
¿Esta API 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.
¿La API ya acepta peticiones?
El endpoint está en despliegue final y todavía no está activo para trabajos, pero su precio y comportamiento ya están publicados para integrarlo apenas abra.
¿Linealizar cambia el contenido de mi PDF?
No. Cada página, imagen y texto se mantiene exactamente igual. Linealizar solo reordena la estructura interna de bytes para que el visor pueda mostrar la primera página antes de que llegue el resto del archivo.
¿Cuál es la diferencia entre linealizar y comprimir un PDF?
La compresión reduce el tamaño del archivo recodificando imágenes o fuentes. Linealizar no reduce el tamaño en absoluto; reordena los bytes para permitir la transmisión y el renderizado progresivo, que es una optimización distinta.
¿Un PDF linealizado sigue funcionando al descargarlo normalmente?
Sí. Un PDF linealizado es un archivo completamente válido que abre correctamente en cualquier lector de escritorio, navegador o visor móvil; el reordenamiento solo agrega la capacidad de empezar a renderizar antes cuando se transmite.
¿Puedo linealizar muchos PDF en lote?
Sí. Cada archivo se envía como un POST independiente y se procesa por su cuenta, así que un lote de documentos puede linealizarse en paralelo y recogerse por webhook a medida que cada uno termina.
¿Qué pasa con mi documento después del proceso?
El archivo original y el resultado linealizado se eliminan tras la ventana de retención y jamás se usan para entrenar nada. La entrega es por webhook firmado o por un enlace firmado válido por 24 horas.
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/linearize \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdf":"https://ejemplo.com/documento.pdf"}'const res = await fetch("https://api.kit.forhosting.com/pdf/linearize", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "https://ejemplo.com/documento.pdf"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/linearize",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/linearize", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"https://ejemplo.com/documento.pdf"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/linearize", 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
{
"pdf": "https://ejemplo.com/documento.pdf"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.linearize",
"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. |