이미지 파일을 PDF로 변환하기
이미지를 PDF로는 올린 PNG, JPEG, GIF, BMP 이미지를 한 장씩 한 페이지에 놓아 PDF 하나로 올린 순서대로 돌려줍니다. 페이지 크기는 이미지 크기를 따릅니다.
여기에 파일을 끌어다 놓거나, 클릭해 고릅니다
PNG, JPG, JPEG, GIF, BMP 지원 · 파일당 최대 500.0 MB
Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.
이미지를 PDF로는 업로드한 각 래스터를 `pdfio::embed_image_page`로 별도 페이지에 넣습니다. PNG 한 장이면 충분합니다. 여러 파일은 업로드 순서대로 여러 페이지가 됩니다. 출력은 첫 파일 이름을 따르는 PDF입니다.
폼에는 옵션이 없고, API 필드 `fitOption`, `colorType`, `autoRotate`는 읽히지 않습니다. 각 페이지는 이미지 자체의 크기(1픽셀 = 1포인트)가 되며, 가로세로비, 회색조, 자동 회전은 임베드를 바꾸지 않습니다. 투명도는 평탄화됩니다. 이미지는 RGB로 변환되고 알파 채널은 버려집니다.
이 페이지가 받는 형식은 PNG, JPEG, GIF, BMP입니다. SVG는 다른 변환기(`/api/v1/convert/svg/pdf`)이며 이 경로가 아닙니다. 디코딩할 수 없는 래스터 파일은 실패합니다.
OCR도, PDF로 인쇄 드라이버도 아닙니다. 스크린샷 속의 글은 픽셀로 남습니다. 선택 가능한 텍스트가 필요하면 텍스트를 PDF로 바꾸는 도구나 OCR → Markdown을 쓰세요.
각 이미지는 디코딩되어 8비트 RGB로 변환되고, 무손실 Flate 압축을 거친 원시 픽셀로 저장됩니다. JPEG 바이트가 PDF에 그대로 복사되지 않습니다. 그래서 휴대폰 사진으로 만든 PDF는 사진보다 몇 배 클 수 있습니다. 측정한 한 번의 실행에서 4032×3024 픽셀 JPEG 세 장, 합계 9.7MB가 41.5MB짜리 3페이지 PDF가 되었고, 그 PDF에 PDF 압축을 써도 약 4%만 줄었습니다. 같은 사진을 먼저 긴 변 1600픽셀로 줄이자 6.2MB PDF가 나왔습니다.
페이지는 이미지의 픽셀 크기를 따르므로, 너비 4032픽셀 사진은 너비 약 56인치 페이지가 되고, 뷰어는 이를 창에 맞추고 프린터는 용지에 맞게 줄입니다. 페이지는 A4나 Letter가 아닙니다. 작고 평평한 이미지는 작게 남습니다. 테스트에서 800×600 흰색 PNG, 600×800 JPEG, 반투명 원이 있는 400×400 PNG는 첫 파일 이름을 딴 `a.pdf`라는 11,407바이트짜리 3페이지 PDF 하나로 돌아왔습니다.
변환기는 EXIF 방향 태그를 읽지 않습니다. 휴대폰이 회전 플래그와 함께 가로 픽셀로 저장한 세로 사진은 가로 페이지로 나옵니다. 나중에 PDF 회전에 그 페이지 번호와 90을 입력해 바로잡으세요. 업로드하기 전에 사진 앱에서 사진을 회전해도 됩니다.
실패하는 경우는 이렇습니다. PDF나 .png라는 이름의 텍스트 파일처럼 디코딩할 수 없는 이미지는 HTTP 400과 이유 `unsupported_file_type`, 메시지 "The file is not a supported image."를 반환합니다. HEIC는 허용 목록에 없으므로 먼저 JPEG로 내보내세요. 묶음 중 파일 하나가 잘못되면 요청 전체가 실패하고 PDF는 반환되지 않으므로, 잘못된 파일을 빼고 묶음을 다시 보내세요.
이웃한 도구들입니다. 이미지를 PDF로는 그림으로 남아야 하는 그림용입니다. 선택할 수 있는 텍스트가 필요하면 OCR은 검색 가능한 PDF가 아니라 Markdown을 반환합니다. 반대로 가려면 PDF를 이미지로가 페이지를 JPEG나 PNG로 렌더합니다. 이미 너무 큰 PDF는 만들기 전에 사진을 줄이세요. PDF 압축은 원시 픽셀 페이지에서 많이 건지지 못합니다.
기능
- 로컬 lopdf 임베드로 이미지마다 한 페이지
- 단일 파일도 유효. 추가 파일은 페이지로 이어짐
- 옵션 없음. 각 페이지는 이미지 크기가 되고 알파는 버려짐
- 익명 API: /api/v1/convert/img/pdf
이런 경우에
- 휴대폰 사진 한 장을 업로드 포털용 한 페이지 PDF로 만듦
- 스캔 여러 장을 다시 인쇄하지 않고 페이지로 쌓음
- A4에 맞추지 않고 원래 픽셀 크기를 유지
- 사진을 줄인 뒤 촬영한 영수증을 경비 보고서용 첨부 하나로 묶음
- 내보낸 슬라이드 스크린샷을 텍스트를 선택할 필요 없는 빠르게 읽는 PDF로 만듦
이미지를 PDF로 변환하려면?
- PNG, JPEG, GIF, BMP 파일을 하나 이상 추가합니다. 순서가 곧 페이지 순서입니다.
- 옵션은 없습니다. 각 페이지는 이미지 크기가 됩니다.
- 처리를 누르고 PDF를 내려받습니다.
- 열어서 쪽수가 이미지 수와 맞는지 확인합니다.
- 휴대폰 사진은 올리기 전에 가장 작은 글씨가 읽히는 한도에서 가장 작은 크기로 줄이고, 바로 세워야 하는 세로 사진은 회전해 두세요.
- 첨부하기 전에 파일 크기를 확인합니다. 이미지보다 훨씬 크면 돌아가 사진을 줄이고 변환을 다시 실행하세요.
제한과 경계
- 페이지 맞춤, 회색조, 자동 회전 없음
- 투명한 영역은 알파 채널을 잃음
- OCR 아님. 스크린샷은 이미지로 남음
- SVG는 다른 엔드포인트
- 파일 크기는 원본 JPEG 크기가 아니라 원시 픽셀 수를 따름
- 페이지는 A4나 Letter가 아니라 이미지의 픽셀 크기를 따름
- HEIC와 PNG, JPEG, GIF, BMP 외의 형식은 거절됨
- 디코딩할 수 없는 파일 하나가 묶음 전체를 실패시킴
- 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.
예시
- receipt.png를 올리면 그 PNG 크기의 한 페이지짜리 PDF가 나옴
- a.jpg, b.jpg 순서로 올리면 a, b 순서의 두 페이지가 나옴
- 각각 약 3.2MB인 4032×3024 JPEG 세 장은 41.5MB의 3페이지 PDF가 되고, 같은 사진을 긴 변 1600픽셀로 줄이면 6.2MB가 됨
- 800×600 PNG, 600×800 JPEG, 400×400 PNG를 함께 올리면 첫 파일 이름을 따른 3페이지 PDF가 됨
- 이 도구에 PDF를 올리면 파일 대신 `unsupported_file_type`과 함께 400이 반환됨
이 도구의 개인정보 안내
파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- 이미지가 두 장 필요한가요?
- 아닙니다. 이미지 한 장이면 한 페이지짜리 PDF가 됩니다. 둘 이상이면 업로드 순서대로 이어집니다.
- 회색조로 바꾸거나 이미지를 A4에 맞출 수 있나요?
- 없습니다. 서버는 디코딩된 픽셀을 이미지와 같은 크기의 페이지에 그대로 임베드합니다.
- SVG를 여기로 보낼 수 있나요?
- 이 엔드포인트로는 안 됩니다. SVG는 convert/svg/pdf의 WeasyPrint 경로로 갑니다.
- EXIF 회전이 적용되나요?
- autoRotate는 무시됩니다. 방향은 이미지 디코더가 내놓는 그대로입니다.
- PDF가 사진보다 훨씬 큰 이유는요?
- 변환기는 JPEG 데이터를 유지하지 않고 디코딩한 RGB 픽셀을 무손실 압축으로 저장합니다. 한 테스트에서 3.2MB짜리 휴대폰 사진 세 장이 41.5MB PDF가 되었습니다. 변환하기 전에 사진을 줄이세요. 그 파일에 나중에 PDF 압축을 써도 약 4%만 줄었습니다.
- 한 페이지만 옆으로 누운 이유는요?
- 사진에 이 도구가 읽지 않는 EXIF 회전 플래그가 있어서 페이지가 저장된 픽셀 배치를 그대로 씁니다. 그 페이지에 PDF 회전을 90으로 쓰거나, 사진 앱에서 그림을 회전한 뒤 그 사본을 변환하세요.
- iPhone의 HEIC 사진을 올릴 수 있나요?
- 아닙니다. 받는 형식은 PNG, JPEG, GIF, BMP입니다. 카메라 형식을 가장 호환성 높은 옵션으로 바꾸거나 JPEG로 내보낸 뒤 그 파일을 올리세요.
- 페이지 순서는 어떻게 정해지고 파일 이름은 무엇인가요?
- 페이지 순서는 업로드 순서이며, 다운로드 이름은 처음 추가한 파일 이름에 .pdf 확장자가 붙은 것입니다.
- 파일 하나가 이미지가 아니면 어떻게 되나요?
- HTTP 400과 "The file is not a supported image." 메시지로 요청이 실패합니다. 일부만 만든 PDF는 반환되지 않으므로 그 파일을 빼고 묶음을 다시 실행하세요.
최종 업데이트:
코드에서 호출하기
이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/convert/img/pdf" \
-F "[email protected]" \
-F "[email protected]" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 '이미지를 PDF로' 작업을 대신 실행합니다: /skills/pdf123-images-to-pdf.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.