Ir al contenido principal
PPDF123

Añadir una imagen a un PDF

Añadir imagen coloca una imagen PNG, JPEG o SVG en un PDF en la posición x e y que indiques, en puntos desde la esquina inferior izquierda. Solo estampa la primera página, salvo que elijas todas.

Arrastra archivos aquí, o haz clic para elegir

Admite PDF · hasta 500.0 MB por archivo · hasta 20 archivos a la vez

También puedes pegar un archivo con Ctrl/Cmd+V o desde el menú del portapapeles.

Añadir imagen superpone `imageFile` en `(x,y)`, en puntos PDF (origen abajo a la izquierda). Un archivo ráster se convierte en un XObject Flate. Un SVG se imprime con WeasyPrint y luego se importa como Form. Con `everyPage=true` se estampan todas las páginas; si no, solo la primera.

La descarga se llama `overlayed_{base}.pdf`. Los archivos protegidos con contraseña se descifran por ti en esta página cuando introduces la contraseña; quien use la API debe pasar antes por Quitar contraseña.

No hay campo de escala; el tamaño es el ancho y alto nativos de la imagen en la matriz `cm`. La opacidad no es un parámetro.

Para una marca de texto usa Añadir sello. Para otro PDF como capa, Superponer PDF.

La imagen se dibuja encima del contenido existente de la página, en la última posición del orden de dibujo. No reemplaza ni oculta nada de lo que hay debajo a nivel estructural: el texto y los gráficos de debajo siguen en el archivo, solo quedan tapados donde la imagen es opaca. Por eso sirve para un logotipo en una esquina libre, pero no para cubrir contenido confidencial, que requiere una herramienta de redacción de verdad.

La colocación es una única ancla. `x` e `y` indican la esquina inferior izquierda de la imagen en puntos, medidos desde la esquina inferior izquierda de la página, y la imagen se extiende desde ahí hacia la derecha y hacia arriba. El tamaño no lo eliges tú: un ráster se coloca a un punto PDF por píxel, así que un PNG de 300 por 100 píxeles ocupa 300 por 100 puntos, unas 4,2 por 1,4 pulgadas. Una página carta mide 612 por 792 puntos, así que cualquier cosa bastante más ancha se saldrá de la página. Cambia el tamaño de la imagen al que quieras antes de subirla.

Las imágenes ráster (PNG y JPEG) se decodifican y se vuelven a guardar como RGB de 8 bits. La transparencia no se conserva, así que un PNG con fondo transparente puede mostrar un bloque sólido en lugar de la zona transparente. Si necesitas un logotipo que se integre con la página, expórtalo antes con fondo blanco o del mismo color, o colócalo solo sobre una zona blanca.

`everyPage=false` pone la imagen solo en la página 1; `everyPage=true` la repite en las mismas coordenadas en todas las páginas. Las páginas de distinto tamaño reciben la misma ancla, así que en un archivo mixto la marca puede caer en sitios visualmente distintos. No hay forma de elegir solo las páginas 2 y 5; si lo necesitas, divide el archivo, sella la parte que quieras y vuelve a unirlo.

Si la subida falla, la causa habitual es un archivo que no es una imagen que el decodificador entienda, lo que devuelve un mensaje de tipo de archivo no admitido, o la falta de `imageFile`. Vuelve a exportar la imagen como PNG o JPEG e inténtalo de nuevo.

Funciones

  • XObject ráster, o Form de SVG vía WeasyPrint
  • `x`,`y` en puntos; primera página o todas
  • Sin controles de opacidad ni escala
  • API anónima: /api/v1/misc/add-image

Cuándo usarla

  • Poner un logotipo PNG en la página 1
  • Repetir una marca en un punto fijo de cada página
  • Meter un SVG en WeasyPrint si te vale la precisión de impresión
  • Añadir la imagen escaneada de una firma en la línea de firma de un acuerdo de una página
  • Poner el sello de una empresa en el pie de cada página de un informe con páginas del mismo tamaño

¿Cómo añado una imagen a un PDF?

  1. Sube un PDF y una imagen (PNG, JPEG o SVG).
  2. Pon x e y en puntos desde abajo a la izquierda.
  3. Elige solo la primera página o todas.
  4. Descarga overlayed_*.pdf y comprueba el anclaje.

Límites y casos límite

  • Sin campos de escala/opacidad
  • Un solo punto de anclaje: no se eligen páginas sueltas, solo la primera o todas
  • No elimina ni oculta el contenido que queda debajo de la imagen
  • Un ráster enorme se coloca enorme en el PDF
  • Las zonas transparentes de un PNG no se conservan: las imágenes se convierten a RGB, así que los píxeles transparentes toman el color guardado debajo, a menudo negro
  • Los archivos protegidos con contraseña necesitan la contraseña; quien use la API debe pasar antes por Quitar contraseña
  • Límite de subida en este sitio web: 500 MB por archivo, enviado por partes a partir de unos 95 MB. El cuerpo de una sola petición directa a la API está limitado a 100 MB.

Ejemplos

  • x=0 y=0 pone la esquina inferior izquierda de la imagen en la de la página
  • Con everyPage en false, la página 2 y siguientes no cambian
  • Un logotipo PNG de 200 por 80 píxeles con x=400, y=20 y everyPage=true queda en la esquina inferior derecha de cada página carta, con 200 puntos de ancho, y la descarga se llama overlayed_report.pdf para un archivo de entrada llamado report.pdf
  • Una foto de 1800 píxeles de ancho colocada en x=0, y=0 cubre mucho más que una página de 612 puntos de ancho, lo que demuestra que el tamaño colocado sigue los píxeles; reduce antes la imagen a unos 150 píxeles de ancho

Privacidad de esta herramienta

Los archivos se suben por HTTPS, se procesan en memoria o en un directorio temporal de corta duración en nuestros servidores, y se eliminan cuando el resultado está listo. No conservamos copias para consultarlas después, entrenar modelos ni crear perfiles publicitarios. Consulte la Política de privacidad para los plazos de retención y las cookies de AdSense.

Preguntas frecuentes

¿Por qué el logotipo es enorme?
La matriz cm trata el ancho y alto en píxeles de la imagen como unidades PDF. Un PNG de 2000 px tiene 2000 puntos de ancho.
¿y se cuenta desde arriba?
No. En las páginas habituales el espacio PDF tiene el origen abajo a la izquierda.
¿Puedo poner opacidad?
No. La superposición son operadores de dibujo opacos.
¿El SVG sigue siendo vector?
WeasyPrint lo imprime a un PDF de una página y se coloca como form. Espera una impresión, no un SVG editable.
¿Cómo hago la imagen más pequeña?
Cámbiale el tamaño antes de subirla. No hay campo de escala y el tamaño colocado sigue las dimensiones en píxeles de la imagen, así que un logotipo de 150 por 50 píxeles ocupa 150 por 50 puntos.
¿Por qué mi PNG transparente muestra un recuadro negro o sólido?
Las imágenes se convierten a RGB y se descarta el canal alfa. Vuelve a exportar el logotipo sobre fondo blanco, o colócalo en una parte de la página que sea blanca.
¿Puedo poner la imagen solo en la página 3?
No directamente. La opción es la página 1 o todas. Separa la página que quieras, añade la imagen ahí y vuelve a unir los archivos en orden.
¿Puedo usar esto para ocultar texto de la página?
No de forma segura. El texto sigue en el archivo bajo la imagen y aún se puede seleccionar o extraer. Usa Ennegrecer texto cuando el contenido deba eliminarse.
La imagen se sale de la página. ¿Cómo encuentro las coordenadas correctas?
Mide desde la esquina inferior izquierda en puntos. En una página carta son 612 por 792, así que x=450 e y=40 colocan la esquina inferior izquierda de un logotipo cerca de abajo a la derecha, siempre que el logotipo quepa en los 162 puntos de ancho restantes.

Última actualización:

Llámalo desde el código

Cada herramienta del sitio es un endpoint REST. Para uso anónimo no hace falta cuenta ni clave de API. Sirve igual para el navegador, para desarrolladores y para agentes de IA.

curl -X POST "https://pdf123.xyz/api/v1/misc/add-image" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "x=0" \
  -F "y=0" \
  -F "everyPage=false" \
  -o output.pdf

También está disponible como herramienta MCP para clientes de agentes que hablan Model Context Protocol (JSON-RPC 2.0 por POST /mcp). Referencia completa de la API

Úsalo desde un agente de IA

Skill

Con esta skill, Claude Code, Codex, Cursor y otros agentes de IA pueden usar «Añadir imagen» por ti: /skills/pdf123-add-image.md

Todas las skills para agentes

Los archivos se usan solo para este trabajo y se borran automáticamente después.