Colocar uma Imagem em um PDF
Adicionar imagem coloca uma figura PNG, JPEG ou SVG num PDF na posição x e y que você informa, em pontos a partir do canto inferior esquerdo. Só a primeira página recebe a imagem, a menos que você escolha todas as páginas.
Arraste arquivos para cá, ou clique para escolher
Aceita PDF · até 500.0 MB por arquivo · até 20 arquivos por vez
Você também pode colar um arquivo com Ctrl/Cmd+V ou pelo menu da área de transferência.
Adicionar imagem sobrepõe `imageFile` nas coordenadas em pontos `(x,y)` do PDF (origem no canto inferior esquerdo). Arquivos raster viram XObject Flate. SVG passa pelo WeasyPrint e entra como Form. Com `everyPage=true`, cobre todas as páginas; senão, só a primeira.
O download se chama `overlayed_{base}.pdf`. Arquivos protegidos por senha são desbloqueados para você nesta página assim que você digita a senha; quem chama a API executa Remover senha antes.
Não há campo de escala. O tamanho vem da largura e altura nativas da imagem na matriz `cm`. Opacidade não é parâmetro.
Para marca de texto, use Adicionar carimbo. Para outro PDF como camada, use Sobrepor PDFs.
A imagem é desenhada sobre o conteúdo existente da página, na última posição da ordem de desenho. Ela não substitui nem esconde nada por baixo em nível estrutural: o texto e os gráficos de baixo continuam no arquivo, apenas cobertos onde a imagem é opaca. Por isso serve bem para um logotipo num canto livre e não serve para cobrir conteúdo confidencial, que exige uma ferramenta de tarja de verdade.
O posicionamento é uma âncora única. `x` e `y` dão o canto inferior esquerdo da imagem, em pontos, a partir do canto inferior esquerdo da página, e a imagem se estende dali para a direita e para cima. Você não escolhe o tamanho: um raster é colocado com um ponto PDF por pixel, então um PNG de 300 por 100 pixels ocupa 300 por 100 pontos, cerca de 4,2 por 1,4 polegadas. Uma página carta tem 612 por 792 pontos, então qualquer coisa muito mais larga sai da página. Redimensione a imagem para o tamanho desejado antes de enviar.
Imagens raster (PNG e JPEG) são decodificadas e gravadas de novo em RGB de 8 bits. A transparência não é mantida, então um PNG com fundo transparente pode mostrar um bloco sólido no lugar da área vazada. Se você precisa de um logotipo que se misture com a página, exporte-o antes com fundo branco ou da mesma cor da página, ou coloque-o só numa área branca.
`everyPage=false` coloca a imagem só na página 1; `everyPage=true` a repete nas mesmas coordenadas em todas as páginas. Páginas de tamanhos diferentes recebem a mesma âncora, então num arquivo misto a marca pode cair em pontos visuais diferentes. Não há como escolher só as páginas 2 e 5; divida o arquivo, carimbe a parte desejada e junte de volta se precisar disso.
Se o envio falhar, a causa habitual é um arquivo que não é uma imagem que o decodificador entenda, o que gera uma mensagem de tipo de arquivo não suportado, ou a falta de `imageFile`. Exporte a imagem de novo como PNG ou JPEG e tente outra vez.
Recursos
- XObject raster, ou Form de SVG via WeasyPrint
- `x` e `y` em pontos; primeira página ou todas
- Sem controles de opacidade ou escala
- API anônima: /api/v1/misc/add-image
Quando usar esta ferramenta
- Colocar um logo PNG na página 1
- Repetir uma marca num ponto fixo em todas as páginas
- Enviar SVG ao WeasyPrint quando a precisão de impressão basta
- Adicionar a imagem de uma assinatura digitalizada na linha de assinatura de um contrato de uma página
- Pôr o selo da empresa no rodapé de todas as páginas de um relatório com páginas de tamanho uniforme
Como adicionar uma imagem a um PDF?
- Envie o PDF e uma imagem (PNG, JPEG ou SVG).
- Defina x e y em pontos a partir do canto inferior esquerdo.
- Escolha só a primeira página ou todas.
- Baixe overlayed_*.pdf e confira o ancoramento.
Limites e casos-limite
- Sem campos de escala/opacidade
- Só um ponto de âncora: sem seleção de páginas além de primeira página ou todas
- Não remove nem esconde o conteúdo que está por baixo da imagem
- Rasters enormes viram colocações enormes no PDF
- Áreas transparentes de PNG não são preservadas: as imagens são convertidas para RGB, então os pixels transparentes assumem a cor guardada por baixo, muitas vezes preto
- Arquivos protegidos por senha exigem a senha; quem chama a API executa Remover senha antes
- Limite de envio neste site: 500 MB por arquivo, enviado em partes acima de cerca de 95 MB. O corpo de uma única requisição direta à API é limitado a 100 MB.
Exemplos
- x=0 y=0 coloca o canto inferior esquerdo da imagem no canto inferior esquerdo da página
- Com everyPage=false, a página 2 em diante não muda
- Um logo PNG de 200 por 80 pixels com x=400, y=20 e everyPage=true fica no canto inferior direito de todas as páginas tamanho carta, com 200 pontos de largura, e o download se chama overlayed_report.pdf para uma entrada chamada report.pdf
- Uma foto de 1800 pixels de largura colocada em x=0, y=0 passa muito de uma página de 612 pontos de largura, o que mostra que o tamanho segue os pixels; reduza a imagem para cerca de 150 pixels de largura antes
Privacidade desta ferramenta
Os arquivos são enviados por HTTPS, processados em memória ou em um diretório temporário de curta duração nos nossos servidores, e apagados quando o resultado fica pronto. Não guardamos cópias para consulta posterior, treino de modelos ou perfis de publicidade. Consulte a Política de Privacidade para prazos de retenção e cookies do AdSense.
Perguntas frequentes
- Por que o logo ficou enorme?
- A matriz cm trata a largura e a altura em pixels como unidades PDF. Um PNG de 2000 px fica com 2000 pontos de largura.
- O y conta a partir do topo?
- Não. No espaço típico de página PDF, a origem fica no canto inferior esquerdo.
- Dá para definir opacidade?
- Não. A sobreposição é um operador de desenho opaco.
- O SVG continua vetorial?
- O SVG é impresso pelo WeasyPrint numa página PDF e depois colocado como Form. Espere um resultado de impressão, não um SVG editável.
- Como deixo a imagem menor?
- Redimensione-a antes de enviar. Não há campo de escala, e o tamanho final segue as dimensões em pixels da imagem, então um logotipo de 150 por 50 pixels ocupa 150 por 50 pontos.
- Por que meu PNG transparente aparece com uma caixa preta ou sólida?
- As imagens são convertidas para RGB e o canal alfa é descartado. Exporte o logotipo de novo com fundo branco, ou coloque-o numa parte da página que seja branca.
- Posso colocar a imagem só na página 3?
- Não diretamente. A escolha é página 1 ou todas as páginas. Separe a página desejada, adicione a imagem nela e depois junte os arquivos de volta, em ordem.
- Posso usar isto para esconder texto da página?
- Não com segurança. O texto continua no arquivo, por baixo da imagem, e ainda pode ser selecionado ou extraído. Use Tarjar texto quando o conteúdo precisar ser removido.
- A imagem saiu da página. Como acho as coordenadas certas?
- Meça a partir do canto inferior esquerdo, em pontos. Numa página carta isso é 612 por 792, então x=450 e y=40 colocam o canto inferior esquerdo de um logotipo perto do canto inferior direito, desde que o logotipo caiba nos 162 pontos de largura restantes.
Última atualização:
Chame pelo código
Cada ferramenta deste site é um endpoint REST. Para uso anônimo não precisa de conta nem de chave de API. Serve para o navegador, para desenvolvedores e 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.pdfTambém disponível como ferramenta MCP para clientes de agente que falam Model Context Protocol (JSON-RPC 2.0 via POST /mcp). Referência completa da API
Use a partir de um agente de IA
SkillCom esta skill, Claude Code, Codex, Cursor e outros agentes de IA podem usar "Adicionar imagem" para você: /skills/pdf123-add-image.md
Os arquivos servem só para este processamento e são apagados automaticamente depois.