Comprimir un PDF
Un PDF cargado de escaneos en alta resolución o imágenes sin comprimir puede crecer hasta un tamaño que ningún límite de adjunto de correo o formulario de carga acepta. Esta API para comprimir PDF recodifica las imágenes, elimina datos redundantes y reconstruye el archivo para que pese muchísimo menos, sin convertir el texto en un borrón ni las imágenes en manchas de artefactos.
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 los PDF con sobrepeso
Un contrato escaneado a 600 DPI, un informe lleno de capturas de pantalla sin optimizar o una prueba de diseño exportada a resolución de imprenta puede fácilmente pesar decenas de megabytes, y ese peso genera fricción real: correos que rebotan, cargas lentas, facturas de almacenamiento que crecen y visores móviles que se traban al renderizar una sola página. La mayor parte de ese volumen no es el texto, sino imágenes incrustadas a una resolución muy superior a la que una pantalla o una impresión estándar realmente necesita. Este endpoint apunta exactamente a ese desperdicio.
Cómo funciona la compresión
Llama a POST /pdf/compress y la solicitud devuelve un task_id de inmediato, ya que el trabajo corre de forma asíncrona. Internamente, las imágenes incrustadas se recodifican a una calidad y resolución razonables para uso en pantalla e impresión estándar, se eliminan objetos redundantes y sin usar, y la estructura de la página se reconstruye de forma más eficiente. El texto permanece como texto: los glifos vectoriales nunca se rasterizan ni se degradan, así que un PDF comprimido sigue seleccionándose, buscándose e imprimiéndose con nitidez aunque el archivo en sí pese mucho menos.
Por qué los PDF llegan a pesar tanto
El formato PDF se diseñó para incrustar imágenes con su fidelidad original, de modo que un documento se imprimiera idéntico en cualquier lugar, y durante décadas eso significó que las herramientas de autoría preservaban por defecto cada píxel que producía un escáner o una cámara. Esa decisión de diseño tenía sentido para la fidelidad de archivo, pero implica que una gran proporción de los PDF cotidianos llevan imágenes a dos o tres veces la resolución que jamás se mostrará en pantalla. Comprimir es simplemente el paso de ajustar la resolución al uso real, y por eso un archivo bien comprimido puede verse idéntico en pantalla mientras pesa una fracción de lo original.
Dónde encaja en una tubería
Coloque este paso justo antes de que los documentos salgan de su sistema: antes de adjuntarlos a un correo, de subirlos a un portal con límite de tamaño, o de archivar miles de archivos donde el costo de almacenamiento se acumula. También combina bien después de un paso de escaneo a PDF o de fusión, ya que ahí es exactamente donde suelen aparecer los archivos con sobrepeso. Como el precio escala con el tamaño del documento, el comportamiento es predecible incluso en un lote con pesos muy distintos.
Entrega, precio y estado
El archivo comprimido se entrega por un webhook firmado, recomendado para automatización, o un enlace firmado válido durante 24 horas; el origen y la salida se eliminan tras la ventana de retención y nunca se usan para entrenar modelos. El precio es $0.041 por solicitud más $0.003 por megabyte procesado, así que el costo es transparente y está ligado directamente al trabajo realizado. Este endpoint está actualmente en despliegue — todavía no acepta trabajos en producción — y estará disponible en breve; verifique el estado del endpoint antes de integrarlo en un flujo productivo.
Qué puede hacer con ella
Ajustar un adjunto de correo a un límite de tamaño
Reduzca un acuerdo escaneado o un informe lleno de capturas de pantalla de decenas de megabytes a un peso que pasa los límites típicos de adjuntos de correo, sin volver a escanear ni reexportar nada.
Acelerar las cargas en un portal documental
Comprima los PDF enviados por clientes antes de que lleguen a un formulario de carga con límite estricto de tamaño, reduciendo cargas fallidas y tickets de soporte causados por archivos con sobrepeso.
Reducir el costo de almacenamiento a largo plazo
Pase un lote de documentos escaneados antiguos por compresión una sola vez, reduciendo significativamente el almacenamiento total del archivo mientras cada página sigue siendo completamente legible.
Optimizar PDF generados desde exportaciones de diseño o imprenta
Comprima pruebas PDF a resolución de imprenta antes de distribuirlas para revisión en pantalla, ya que los revisores solo necesitan calidad de pantalla, no calidad lista para prensa.
Preguntas frecuentes
¿Cómo comprimo un PDF con una API?
Envíe el documento a POST /pdf/compress, que devuelve un task_id de inmediato. El archivo más liviano y recodificado se entrega a su webhook firmado o a un enlace firmado cuando termina el procesamiento.
¿La API para comprimir PDF 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 compresión difumina el texto?
No. El texto se conserva como glifos vectoriales y nunca se rasteriza, así que permanece nítido, seleccionable y buscable. Solo las imágenes incrustadas se recodifican a una calidad y resolución razonables.
¿Cuánto se reduce realmente un PDF?
Depende por completo del archivo de origen: un documento dominado por escaneos en alta resolución o imágenes sin comprimir se reduce más, mientras que un PDF de puro texto con pocas imágenes ve una reducción menor, ya que hay menos datos redundantes que quitar.
¿Puedo comprimir PDF por lote?
Sí. Cada solicitud es una tarea asíncrona independiente, así que puede enviar lotes grandes en paralelo y recoger cada resultado comprimido por webhook a medida que termina.
¿La compresión afecta notablemente la calidad de las imágenes?
Las imágenes se recodifican a una calidad adecuada para visualización normal en pantalla e impresión estándar, un nivel que la mayoría no distingue del original a zoom típico, aunque una inspección a nivel de píxel con zoom extremo podría mostrar diferencias.
¿Este endpoint está activo ahora mismo?
Está en despliegue y todavía no acepta trabajos; estará disponible en breve. Verifique el estado actual del endpoint antes de integrarlo en un flujo productivo.
¿Cómo se calcula el costo para un lote grande?
Cada solicitud cuesta un fijo de $0.041 más $0.003 por megabyte del documento procesado, así que el costo total escala de forma predecible con la cantidad y el tamaño de los archivos del lote.
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/compress \
-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/compress", {
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/compress",
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/compress", 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/compress", 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.compress",
"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. |