Posa una imatge en un PDF
Afegeix una imatge col·loca una imatge PNG, JPEG o SVG en un PDF a la posició x i y indicada, en punts des de la cantonada inferior esquerra. Només segella la primera pàgina si no trieu totes les pàgines.
Arrossega arxius aquí, o fes clic per triar-los
Admet PDF · fins a 500.0 MB per arxiu · fins a 20 arxius alhora
També pots enganxar un fitxer amb Ctrl/Cmd+V o des del menú del porta-retalls.
Afegeix una imatge superposa `imageFile` a les coordenades PDF `(x,y)` (origen a l'inferior esquerra). Els ràsters esdevenen XObject Flate. L'SVG passa per WeasyPrint i s'importa com a Form. Amb `everyPage=true` es segellen totes les pàgines; si no, només la primera.
La baixada s'anomena `overlayed_{base}.pdf`. Els fitxers protegits amb contrasenya es desbloquegen per vosaltres en aquesta pàgina un cop n'escriviu la clau; els clients d'API executen primer «Treu la contrasenya».
No hi ha cap camp d'escala; la mida és l'amplada i l'alçada natives de la imatge a la matriu `cm`. L'opacitat no és cap paràmetre.
Per a una marca de text feu servir «Afegeix un segell». Per a un altre PDF com a capa, «Superposa PDF».
La imatge es dibuixa damunt del contingut existent de la pàgina, a l'última posició de l'ordre de dibuix. No substitueix ni amaga res de sota a nivell estructural: el text i els gràfics de sota continuen al fitxer, només queden coberts allà on la imatge és opaca. Per això va bé per a un logotip en una cantonada lliure, però no serveix per cobrir contingut confidencial, que necessita una eina d'ocultació real.
La col·locació és un sol ancoratge. `x` i `y` donen la cantonada inferior esquerra de la imatge en punts des de la cantonada inferior esquerra de la pàgina, i la imatge s'estén cap a la dreta i cap amunt des d'allà. La mida no la trieu vosaltres: un ràster es col·loca a un punt PDF per píxel, de manera que un PNG de 300 per 100 píxels ocupa 300 per 100 punts, uns 4,2 per 1,4 polzades. Una pàgina carta fa 612 per 792 punts, així que qualsevol cosa molt més ampla sortirà de la pàgina. Canvieu la mida de la imatge abans de pujar-la.
Les imatges ràster (PNG i JPEG) es descodifiquen i es tornen a desar com a RGB de 8 bits. La transparència no es conserva, així que un PNG amb fons transparent pot mostrar un bloc sòlid en lloc de la zona transparent. Si necessiteu un logotip que es fongui amb la pàgina, exporteu-lo abans amb un fons blanc o equivalent, o col·loqueu-lo només sobre una zona blanca.
`everyPage=false` posa la imatge només a la pàgina 1; `everyPage=true` la repeteix a les mateixes coordenades a cada pàgina. Les pàgines de mides diferents reben el mateix ancoratge, de manera que en un fitxer mixt la marca pot caure en llocs visualment diferents. No hi ha manera de triar només les pàgines 2 i 5; si ho necessiteu, partiu el fitxer, segelleu la part que voleu i torneu-lo a unir.
Si la pujada falla, la causa habitual és un fitxer que no és una imatge que el descodificador entengui, cosa que retorna un missatge de tipus de fitxer no admès, o bé la manca d'`imageFile`. Torneu a exportar la imatge com a PNG o JPEG i proveu-ho de nou.
Funcions
- XObject ràster o Form d'SVG via WeasyPrint
- `x`,`y` en punts; primera pàgina o totes
- Sense control d'opacitat ni d'escala
- API anònima a /api/v1/misc/add-image
Quan fer-la servir
- Posar un logotip PNG a la pàgina 1
- Repetir una marca a cada pàgina en un punt fix
- Passar un SVG per WeasyPrint quan accepteu fidelitat d'impressió
- Afegir una signatura escanejada a la línia de signatura d'un acord d'una pàgina
- Posar el segell d'una empresa al peu de cada pàgina d'un informe amb pàgines de mida uniforme
Com afegeixo una imatge a un PDF?
- Pugeu un PDF i una imatge (PNG, JPEG o SVG).
- Indiqueu x i y des de l'inferior esquerra, en punts.
- Trieu només la primera pàgina o totes.
- Baixeu overlayed_*.pdf i comproveu l'ancoratge.
Límits i casos límit
- Sense camps d'escala ni d'opacitat
- Un sol punt d'ancoratge: no es poden triar pàgines més enllà de la primera o totes
- No elimina ni amaga el contingut que hi ha sota la imatge
- Els ràsters gegants esdevenen col·locacions gegants al PDF
- Les zones transparents dels PNG no es conserven: les imatges es converteixen a RGB, així que els píxels transparents prenen el color guardat a sota, sovint negre
- Els fitxers protegits amb contrasenya en necessiten la clau; els clients d'API executen primer «Treu la contrasenya»
- Límit de pujada en aquest web: 500 MB per fitxer, enviat per parts a partir d'uns 95 MB. El cos d'una sola petició directa a l'API està limitat a 100 MB.
Exemples
- x=0 y=0 posa la cantonada inferior esquerra de la imatge a la cantonada inferior esquerra de la pàgina
- everyPage desactivat deixa les pàgines 2 i següents sense canvis
- Un logotip PNG de 200 per 80 píxels amb x=400, y=20 i everyPage=true queda a la cantonada inferior dreta de cada pàgina de mida carta, amb 200 punts d'ample, i la baixada s'anomena overlayed_report.pdf per a una entrada anomenada report.pdf
- Una foto de 1800 píxels d'ample col·locada a x=0, y=0 cobreix molt més que una pàgina de 612 punts d'ample, cosa que mostra que la mida col·locada segueix els píxels; reduïu abans la imatge a uns 150 píxels d'ample
Privadesa d'aquesta eina
Els fitxers pugen per HTTPS, es processen a la memòria del servidor o en un directori temporal de curta vida, i s'esborren quan el resultat és a punt. No en guardem còpies per consultar-les després, per entrenar models ni per a perfils publicitaris. Els terminis de retenció i les galetes d'AdSense consten a la Política de privacitat.
Preguntes freqüents
- Per què el logotip és enorme?
- La matriu cm usa l'amplada i l'alçada en píxels de la imatge com a unitats PDF. Un PNG de 2000 px fa 2000 punts d'ample.
- La y és des de dalt?
- No. L'espai PDF té l'origen a l'inferior esquerra en les pàgines habituals.
- Puc definir l'opacitat?
- No. La superposició són operadors de dibuix opacs.
- L'SVG conserva els vectors?
- L'SVG s'imprimeix amb WeasyPrint a un PDF d'una pàgina i després es col·loca com a form. Espereu una impressió, no un SVG editable.
- Com puc fer la imatge més petita?
- Canvieu-ne la mida abans de pujar-la. No hi ha cap camp d'escala, i la mida col·locada segueix les dimensions en píxels de la imatge, de manera que un logotip de 150 per 50 píxels ocupa 150 per 50 punts.
- Per què el meu PNG transparent mostra un requadre negre o sòlid?
- Les imatges es converteixen a RGB i es descarta el canal alfa. Torneu a exportar el logotip amb fons blanc, o col·loqueu-lo en una part de la pàgina que sigui blanca.
- Puc posar la imatge només a la pàgina 3?
- No directament. L'elecció és la pàgina 1 o totes. Separeu la pàgina que voleu, afegiu-hi la imatge i torneu a unir els fitxers per ordre.
- Puc fer-ho servir per amagar text de la pàgina?
- No de manera segura. El text continua al fitxer sota la imatge i es pot seleccionar o extreure igualment. Feu servir «Ennegreix text» quan el contingut s'hagi d'eliminar.
- La imatge surt de la pàgina. Com trobo les coordenades correctes?
- Mesureu des de la cantonada inferior esquerra en punts. En una pàgina carta és de 612 per 792, de manera que x=450 i y=40 situen la cantonada inferior esquerra d'un logotip prop de baix a la dreta, sempre que el logotip càpiga en els 162 punts d'amplada que queden.
Darrera actualització:
Crida-ho des del codi
Cada eina del lloc és una interfície REST normal. Per a ús anònim no cal compte ni clau API. Pensat per a agents d'IA i desenvolupadors, igual que per al navegador.
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.pdfTambé hi ha una eina MCP per a clients d'agents que parlen Model Context Protocol (JSON-RPC 2.0 amb POST /mcp). Referència completa de l'API
Fes-lo servir des d'un agent d'IA
SkillAmb aquest skill, Claude Code, Codex, Cursor i altres agents d'IA poden executar «Afegeix una imatge» per tu: /skills/pdf123-add-image.md
Els arxius només serveixen per a aquest processament i s'esborren sols després.