본문으로 건너뛰기
PPDF123

PDF에 이미지 겹치기

이미지 겹치기는 PNG, JPEG, SVG 이미지를 왼쪽 아래에서 잰 포인트 단위 x, y 위치에 PDF에 놓습니다. 모든 페이지를 고르지 않으면 첫 페이지에만 찍힙니다.

여기에 파일을 끌어다 놓거나, 클릭해 고릅니다

PDF 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일

Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.

이미지 겹치기는 PDF 점 좌표 `(x,y)`(원점 왼쪽 아래)에 `imageFile`을 겹칩니다. 래스터 파일은 Flate XObject가 됩니다. SVG는 WeasyPrint로 인쇄한 뒤 Form으로 가져옵니다. `everyPage=true`면 모든 페이지에 찍고, 아니면 첫 페이지만입니다.

다운로드 이름은 `overlayed_{base}.pdf`입니다. 비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 자동으로 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행하세요.

배율 필드가 없습니다. 크기는 `cm` 행렬의 이미지 원본 너비·높이입니다. 불투명도 매개변수도 없습니다.

텍스트 표시는 스탬프 넣기, 다른 PDF를 레이어로 쓰려면 PDF 겹치기를 쓰세요.

업로드는 일시적입니다. 이미지 보관함을 유지하지 않습니다.

기능

  • 래스터 XObject, 또는 SVG는 WeasyPrint Form
  • `x`,`y`는 점 단위. 첫 페이지 또는 모든 페이지
  • 불투명도·배율 조작 없음
  • 익명 API: /api/v1/misc/add-image

이런 경우에

  • 1페이지에 PNG 로고를 놓음
  • 고정 점에 모든 페이지 표시를 반복
  • 인쇄 정밀도만 필요할 때 SVG를 WeasyPrint에 넣음

PDF에 이미지를 넣으려면?

  1. PDF와 이미지(PNG, JPEG, SVG)를 업로드합니다.
  2. 왼쪽 아래 기준으로 점 단위 x, y를 설정합니다.
  3. 첫 페이지만 또는 모든 페이지를 고릅니다.
  4. overlayed_*.pdf를 내려받아 앵커를 확인합니다.

제한과 경계

  • 배율·불투명도 필드 없음
  • 큰 래스터는 거대한 PDF 배치가 됨
  • 투명 PNG의 투명 영역은 유지되지 않음. 이미지가 RGB로 변환되어 투명 픽셀은 밑에 저장된 색(대개 검정)이 됨
  • 비밀번호로 보호된 파일은 비밀번호가 필요(API는 먼저 비밀번호 해제 실행)
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • x=0 y=0이면 이미지 왼쪽 아래가 페이지 왼쪽 아래
  • everyPage가 false면 2페이지 이후는 그대로

이 도구의 개인정보 안내

파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.

자주 묻는 질문

로고가 거대한 이유는요?
cm 행렬이 이미지 픽셀 너비·높이를 PDF 단위로 씁니다. 2000px PNG는 너비 2000포인트입니다.
y는 위에서부터인가요?
아닙니다. 일반 페이지의 PDF 공간 원점은 왼쪽 아래입니다.
불투명도를 설정할 수 있나요?
없습니다. 겹치기는 불투명 그리기 연산자입니다.
SVG는 벡터로 남나요?
SVG는 WeasyPrint로 한 페이지 PDF가 된 뒤 Form으로 놓입니다. 편집 가능한 SVG가 아니라 인쇄물에 가깝습니다.

최종 업데이트:

코드에서 호출하기

이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.

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

Model Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서

AI 에이전트에서 사용하기

스킬

이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 '이미지 겹치기' 작업을 대신 실행합니다: /skills/pdf123-add-image.md

전체 에이전트 스킬

파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.