ForHosting KIT · Documentos y PDF

Superponga dos PDF y describa cada página combinada

Superponer dos PDF explica qué contendrá una composición página a página antes de que usted cree o revise el documento final.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Proporcione una descripción ordenada de cada página del PDF base y otra de cada página del PDF superpuesto. El resultado conserva las correspondencias, indica el orden de las capas y genera una descripción concisa de cada página combinada. Resulta especialmente útil para comprobar plantillas de sellos, membretes, marcas de aprobación y otros elementos gráficos repetidos. Si los documentos tienen cantidades de páginas distintas, la solicitud se rechaza porque no existe una correspondencia inequívoca.

Describa ambos PDF siguiendo el orden de las páginas

Comience con dos matrices que contengan texto extraído o descripciones visuales concisas, una cadena por cada página del PDF. La matriz pages_base representa el documento situado debajo, mientras que pages_overlay representa el documento colocado encima. Mantenga ambas matrices en el orden original: la primera descripción base se empareja con la primera descripción superpuesta, la segunda con la segunda, y así sucesivamente. Una descripción puede mencionar texto, logotipos, sellos, bordes, campos de formulario o cualquier otro elemento relevante para su revisión. Use una cadena vacía cuando una página real esté en blanco; no elimine esa entrada, porque desplazaría todas las correspondencias posteriores. Esta capacidad describe una composición propuesta o extraída, pero no altera los bytes del PDF. Por ello, sirve para controles de flujo, registros de auditoría y vistas previas legibles cuando otro sistema ya extrae el contenido o conoce el diseño de la plantilla. Ambos campos deben ser matrices no vacías, todos sus elementos deben ser cadenas y el límite de entrada evita trabajos inmanejables por accidente.

Interprete el resultado de la superposición

Para cada número de página, la respuesta identifica la capa base inferior y la capa superpuesta superior. El orden explícito importa: un sello, membrete o anotación del PDF superior se dibuja conceptualmente después del documento subyacente y puede cubrir una parte de este en un archivo renderizado. Como las descripciones simples no contienen coordenadas, colores, transparencia, fuentes ni límites exactos de objetos, la herramienta no pretende detectar colisiones píxel por píxel. En su lugar, ofrece un relato determinista de qué material descrito contribuye a cada página compuesta. Las páginas en blanco reciben un tratamiento específico. Si la página superpuesta está vacía, la respuesta indica que la base queda sin obstrucciones; si la base está vacía, solo contribuye la capa superior; y si ambas están vacías, ese estado se registra directamente. Los espacios se normalizan para que las descripciones copiadas de herramientas de extracción sean legibles y estables. Las mismas entradas siempre producen la misma secuencia y redacción, lo que facilita pruebas automáticas y registros de aprobación fiables.

Detecte errores de cantidad de páginas antes de producir

Una superposición solo tiene sentido cuando cada página base cuenta exactamente con una página superior correspondiente. Por eso, la capacidad compara las longitudes de ambas matrices antes de describir nada y devuelve un error de entrada no válida cuando difieren. Este comportamiento estricto detecta un fallo habitual de producción documental: una plantilla de sello de dos páginas aplicada a un contrato de tres, o una portada insertada en un archivo pero no en el otro. Corrija los documentos de origen o añada intencionadamente una descripción de página en blanco para igualar sus estructuras y vuelva a ejecutar la solicitud. La respuesta incluye la cantidad verificada de páginas, el orden global de abajo arriba y un registro numerado por cada pareja, de modo que usted pueda cotejarlo con una orden de trabajo o incorporarlo a una interfaz de revisión. La automatización mediante API cuesta $0.002 por solicitud. Como el procesamiento es local, determinista y no utiliza red ni modelos, las descripciones sensibles no se envían a proveedores externos y la redacción permanece estable entre ejecuciones idénticas.

Revise un sello de aprobación

Confirme que cada página del contrato esté emparejada con la descripción del sello de aprobación o revisión previsto.

Compruebe plantillas de membrete

Describa cómo se apilan el membrete, el pie o los bordes específicos sobre el contenido existente.

Valide el montaje documental

Detecte una página de plantilla ausente o adicional antes de que otro renderizador combine los PDF de producción.

¿Crea esta herramienta un PDF nuevo?

No. Devuelve una descripción estructurada de la composición página por página; no modifica ni renderiza bytes de PDF.

¿Qué PDF queda encima?

pages_overlay es la capa superior y pages_base es la capa inferior.

¿Qué ocurre si las cantidades de páginas difieren?

La solicitud falla con un error de entrada no válida que informa ambas cantidades.

¿Cómo debo representar una página en blanco?

Conserve su posición en la matriz y use una cadena vacía para que las páginas posteriores sigan bien emparejadas.

¿Puede detectar si un sello oculta palabras concretas?

No. Las descripciones textuales no aportan geometría ni transparencia, por lo que el resultado describe capas, no oclusiones píxel por píxel.

¿Cuánto cuesta?

Cada solicitud API cuesta $0.002.

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.

POSThttps://api.kit.forhosting.com/pdf/overlay-two-files

¿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, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/pdf/overlay-two-files \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}'
{
  "pages_base": [
    "Invoice 1042: customer, line items, and total due",
    "Payment terms and bank details"
  ],
  "pages_overlay": [
    "APPROVED stamp centered across the page",
    "APPROVED stamp centered across the page"
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.overlay_two_files",
  "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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb25
max_pages200
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →