본문으로 건너뛰기
PPDF123

PDF에 들어 있는 이미지 꺼내기

이미지 추출은 PDF에 임베드된 래스터 이미지를 꺼내 PNG나 JPEG 파일로 ZIP에 담아 줍니다. 벡터 도형과 페이지의 글은 이미지가 아니므로 포함되지 않습니다.

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

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

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

이미지 추출은 페이지 XObject 이미지를 순회해 Flate/ASCII85/DCT 스트림을 디코딩하고 `image_N.png` 또는 `image_N.jpeg`로 ZIP에 묶습니다. `format` 필드로 png(기본) 또는 jpeg를 고릅니다. 공유 XObject는 한 번만 추출합니다.

LZW 필터가 걸린 이미지는 내부 오류(`LZW images unsupported`)를 반환합니다. XObject 사전이 없는 페이지는 건너뜁니다. 추출할 이미지가 없는 파일도 ZIP을 반환하며, 그 안에는 원하는 파일이 없을 수 있습니다.

각 페이지를 PNG로 렌더하는 것(PDF를 이미지로)이 아니며 OCR도 아닙니다. 벡터 그림은 이미지 XObject가 아니므로 나오지 않습니다.

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

형식 선택이 하는 일은 그림이 PDF 안에 저장된 방식에 따라 다릅니다. JPEG 데이터로 저장되어 있고 JPEG를 고르면 원래 바이트가 다시 인코딩 없이 ZIP에 복사되므로 그림이 내장된 그대로 나옵니다. JPEG 데이터인데 PNG를 고르면 디코딩해 PNG로 쓰며, 그 시점부터는 무손실이지만 JPEG가 이미 잃은 디테일을 되살리지는 못하고 파일이 더 커질 수 있습니다. 일반 픽셀 데이터로 저장되어 있으면 디코딩해 고른 형식으로 쓰며, 이 경우 JPEG 출력은 품질 90으로 인코딩됩니다.

파일은 페이지 순서대로 `image_1`, `image_2`처럼 번호가 붙고, 확장자는 고른 형식을 따릅니다. 번호만으로는 이미지가 어느 페이지에서 왔는지 알 수 없으므로 그림은 직접 보고 구분하세요. 머리글의 로고처럼 같은 이미지 객체가 여러 페이지에서 쓰이면 한 번만 기록됩니다.

그림은 8비트 RGB로 변환됩니다. 회색조 그림은 회색 RGB 이미지가 됩니다. PDF는 그림에 투명도를 주는 별도의 소프트 마스크를 붙일 수도 있는데, 그 마스크는 적용되지 않으므로 오려 낸 사진은 단색 배경으로 나올 수 있습니다. 회색이나 RGB가 아닌 색 모델, 예를 들어 CMYK로 저장된 그림은 픽셀마다 처음 세 색 값만 쓰기 때문에 색이 틀리게 나올 수 있습니다.

파일 속 이미지 하나라도 디코딩할 수 없으면 그 이미지를 건너뛰지 않고 요청 전체가 실패합니다. 메시지에 무엇이 잘못됐는지 나오며, LZW로 압축된 그림은 LZW 이미지를 지원하지 않는다고 나옵니다. 그럴 때는 PDF를 이미지로로 페이지를 그림으로 렌더하거나, 그림 없는 문서를 원한다면 이미지 제거를 쓰세요.

내장된 그림이 없는 PDF도 이미지 파일이 없는 ZIP을 반환합니다. 스캔한 문서는 각 페이지를 그림으로 저장할 수 있으며, 그 경우 이미지 추출은 그 페이지 스캔을 반환합니다. 스캔을 검색 가능한 텍스트로 바꾸려면 Markdown을 반환하는 OCR을 쓰세요.

기능

  • XObject 이미지를 PNG 또는 JPEG의 ZIP으로
  • JPEG 데이터를 JPEG로 고르면 다시 인코딩 없이 바이트 그대로 복사
  • 그 밖의 그림은 8비트 RGB로 디코딩해 PNG로, 또는 품질 90의 JPEG로 기록
  • 객체 id로 중복 제거. LZW 미지원
  • 파일은 페이지 순서대로 image_1, image_2처럼 번호가 붙음
  • 페이지 래스터화도 OCR도 아님
  • 익명 API: /api/v1/misc/extract-images

이런 경우에

  • 디지털로 만든 보고서에서 사진을 꺼냄
  • format=jpeg일 때 JPEG 사진 스트림을 다시 인코딩 없이 되찾음
  • 그림만 필요할 때 전체 페이지를 래스터화하지 않음
  • 카탈로그 PDF의 제품 사진을 슬라이드나 웹 페이지에 재사용
  • 이미지 제거로 지울지 정하기 전에 문서에 어떤 그림이 내장되어 있는지 확인

PDF에서 이미지를 추출하려면?

  1. 스캔 문서, 브로슈어, 사진이 있는 보고서처럼 사진이나 래스터 그림이 내장된 PDF를 업로드합니다.
  2. 사진을 다시 압축하지 않고 JPEG 파일로 저장하려면 JPEG를, 그래픽과 스크린샷에는 PNG를 그대로 두세요.
  3. 처리를 누르고 `{name}_extracted_images.zip`을 내려받아 압축을 풉니다.
  4. 파일을 열어 문서와 눈으로 맞춰 봅니다. 번호는 페이지 순서를 따르지만 페이지를 알려 주지는 않습니다.
  5. ZIP이 비었거나 요청이 실패하면 메시지를 읽으세요. LZW가 나온 실패는 지원되지 않는 압축을 쓰는 이미지가 있다는 뜻이고, 빈 ZIP은 PDF에 꺼낼 내장 그림이 없다는 뜻입니다.

제한과 경계

  • 페이지 렌더러가 아님
  • LZW는 작업을 실패시킴
  • PNG 출력은 RGB이므로 투명도와 소프트 마스크는 사라짐
  • OCR 없음
  • 파일 이름은 페이지 번호가 아니라 발견 순서를 나타냄
  • 디코딩할 수 없는 그림 하나가 작업 전체를 멈춤
  • 벡터 그래픽과 텍스트는 추출되지 않음
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 고유한 사진 XObject가 세 개인 PDF는 ZIP에 image_1부터 image_3까지 나옴
  • 벡터 로고 페이지는 아무것도 내놓지 않을 수 있음
  • 머리글 로고가 8페이지 모두에 반복되고 사진이 2장인 브로슈어는 로고가 한 번만 기록되는 공유 객체이므로 파일 3개가 나옴
  • 텍스트만 있는 보고서는 이미지 파일이 없는 ZIP을 반환하며 오류로 보고되지 않음

이 도구의 개인정보 안내

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

자주 묻는 질문

페이지마다 이미지가 하나씩 나오지 않는 이유는요?
내장 이미지 XObject만 추출합니다. 텍스트와 벡터로 된 페이지에는 이미지가 0개일 수 있습니다.
PDF를 이미지로와 어떻게 다른가요?
PDF를 이미지로는 페이지를 렌더합니다. 이미지 추출은 파일 안에 이미 있는 이미지 객체를 꺼냅니다.
LZW는요?
LZW 디코딩은 구현되어 있지 않습니다. 그 이미지 하나를 건너뛰지 않고 작업이 오류로 끝납니다.
마스크와 SMask는 처리되나요?
출력은 최선을 다한 픽셀 덤프로 보세요. 소프트 마스크와 특이한 색 공간은 틀리게 보일 수 있습니다.
원본 JPEG 파일을 받나요, 다시 압축한 사본을 받나요?
그림이 PDF에 JPEG 데이터로 저장되어 있고 JPEG를 고르면 같은 바이트가 다시 인코딩 없이 나옵니다. PNG를 고르면 그림이 디코딩되어 PNG로 저장됩니다. 원시 픽셀 데이터로 저장된 그림에는 원본 JPEG가 없으므로, JPEG 결과는 품질 90으로 새로 인코딩한 것입니다.
이미지에 페이지 번호 대신 일련번호가 붙은 이유는요?
파일은 페이지 순서대로 image_1, image_2처럼 이름이 붙고, 여러 페이지에서 쓰인 이미지는 한 번만 나옵니다. 이름에는 페이지가 기록되지 않으므로 파일을 열어 어느 것인지 확인하세요.
ZIP이 비었습니다. PDF에 이미지가 없다는 뜻인가요?
빈 ZIP은 도구가 페이지에서 내장 그림 객체를 찾지 못했다는 뜻입니다. 벡터로 그려진 텍스트, 선, 차트는 그림이 아니어서 추출되지 않습니다. 그것들을 그림으로 원한다면 PDF를 이미지로로 페이지를 렌더하세요.
LZW에 대한 메시지와 함께 요청이 실패했습니다. 어떻게 하나요?
파일의 그림 하나가 이 도구가 디코딩할 수 없는 LZW 압축을 쓰며, 그 그림을 건너뛰지 않고 작업 전체가 멈춥니다. PDF를 이미지로로 페이지를 렌더하거나 이미지 제거로 그림을 지우세요.
추출한 사진의 색이 틀린 이유는요?
그림은 픽셀마다 처음 색 값을 써서 8비트 RGB로 변환됩니다. CMYK처럼 회색이나 RGB가 아닌 색 모델로 저장된 그림은 색이 어긋날 수 있습니다. 별도의 소프트 마스크도 적용되지 않습니다.

최종 업데이트:

코드에서 호출하기

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

curl -X POST "https://pdf123.xyz/api/v1/misc/extract-images" \
  -F "[email protected]" \
  -F "format=png" \
  -o output.pdf

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

AI 에이전트에서 사용하기

스킬

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

전체 에이전트 스킬

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