PDF 안에 파일 첨부하기
첨부 관리는 하나 이상의 파일을 첨부로 PDF 안에 넣어 뷰어의 첨부 패널에 목록으로 보이게 합니다. 파일만 추가하며 PDF를 PDF/A-3으로 바꾸지는 않습니다.
여기에 파일을 끌어다 놓거나, 클릭해 고릅니다
PDF 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일
Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.
첨부 관리는 각 `attachments` 파일을 `/EmbeddedFiles`에 EmbeddedFile 스트림과 Filespec으로 넣습니다. 첨부를 하나도 보내지 않으면 오류로 거절됩니다. `convertToPdfA3b`는 무시됩니다. PDF/A-3b로 바꾸지 않습니다.
PDF 병합처럼 PDF를 이어 붙이는 도구가 아니며, 페이지를 겹치는 도구도 아닙니다. 수신자는 첨부를 보여주는 뷰어가 필요합니다.
비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 자동으로 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행하세요. 파일명은 Filespec의 `/F`와 `/UF`에 저장됩니다.
이 체크박스로 PDF/A-3b 인보이스 패키지를 내려받을 수는 없습니다.
각 첨부는 원본 바이트 그대로 기록됩니다. 검사, 변환, 썸네일 생성, 이름 바꾸기는 하지 않으며, 내장 스트림은 `Size` 매개변수가 있는 `application/octet-stream` 타입이라 뷰어에서 꺼내면 원본 파일이 바이트 단위로 똑같이 나옵니다. PDF의 보이는 페이지는 바뀌지 않고 카탈로그에 내장 파일 항목만 추가됩니다.
한 번에 여러 파일을 선택할 수 있고 각각이 별도 항목이 됩니다. 결과는 입력 파일 이름을 따르는 일반 PDF이므로, 첨부 창이 없는 뷰어에서는 원래 페이지만 보이고 내장 파일은 보이지 않습니다. 수신자에게 Acrobat, Foxit 같은 데스크톱 리더에서 클립 아이콘이나 첨부 패널을 찾아보라고 알려 주세요.
추가 파일이 PDF 안에 함께 담겨 가야 할 때 쓰세요. 두 번째 문서의 페이지를 읽는 흐름에 넣으려면 PDF 병합을, 한 페이지를 다른 페이지 위에 올리려면 PDF 겹치기를 쓰세요.
기능
- 한 번에 여러 파일을 넣을 수 있고 각각 별도의 Filespec을 가짐
- 원본 바이트 유지, 보이는 페이지는 그대로
- 파일을 PDF EmbeddedFiles 이름 트리에 삽입
- `convertToPdfA3b`는 사용되지 않음
- 첨부는 하나 이상 필요
- 익명 API: /api/v1/misc/add-attachments
이런 경우에
- PDF 표지 편지에 스프레드시트를 끼움
- Acrobat을 쓰는 검토자에게 원본 파일을 PDF에 실어 보냄
- PDF/A-3 체크박스를 건너뜀
- 보고서와 그래프의 바탕이 된 데이터 CSV를 함께 보내 검토자가 수치를 다시 계산할 수 있게 함
- 서명한 스캔본과 편집 가능한 Word 원본을 한 파일에 담아 전달
PDF에 파일을 첨부하려면?
- PDF와 넣을 파일 하나 이상을 업로드합니다.
- convertToPdfA3b는 꺼 두세요. 변환하지 않습니다.
- 처리를 누르고 PDF를 내려받습니다.
- 데스크톱 뷰어에서 첨부 패널을 엽니다.
- 추가한 파일이 모두 업로드한 파일 이름 그대로 목록에 있는지 확인합니다.
- PDF를 보내기 전에 뷰어에서 첨부 하나를 꺼내 원본과 비교해, 제대로 열리는지 확인하세요.
제한과 경계
- PDF/A-3b가 아님
- PDF 병합이 아님
- 첨부 창이 없는 뷰어는 파일을 숨김
- 크기 검사, 바이러스 검사, 파일 형식 검사는 없음. 바이트가 그대로 내장됨
- 결과는 Factur-X나 ZUGFeRD 패키지 같은 전자 인보이스 컨테이너가 아님
- 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.
예시
- notes.txt를 붙이면 notes.txt라는 EmbeddedFiles 항목이 생김
- convertToPdfA3b를 켜도 일반 PDF가 나옴
- `contract.pdf`와 `budget.xlsx`, `notes.txt`를 업로드하면 EmbeddedFiles 항목이 세 개인 `contract.pdf`가 반환되며 페이지 수는 그대로
- 첨부 파일 없이 PDF만 제출하면 첨부 업로드가 최소 하나 필요하다는 오류가 반환됨. 파일을 추가하고 다시 실행하세요
이 도구의 개인정보 안내
파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- convertToPdfA3b가 PDF/A-3을 만드나요?
- 아닙니다. 플래그는 무시됩니다. Ghostscript PDFA=1/2가 필요하면 PDF를 PDF/A로를 쓰되, 그것이 파트 3이 아님을 알아 두세요.
- 붙인 PDF가 페이지로 합쳐지나요?
- 아닙니다. EmbeddedFiles에 남습니다. 페이지를 잇는 것은 PDF 병합입니다.
- 첨부 파일을 빼먹으면요?
- bad-request 오류로 요청이 실패합니다. 첨부 업로드가 최소 하나는 필요합니다.
- 내장 스트림에 특별한 압축이 있나요?
- Size 매개변수가 있는 application/octet-stream으로 저장됩니다. PDF/A-3 연관 파일로 가정하지 마세요.
- 첨부 파일이 보이지 않는 이유는요?
- 파일은 내장되어 있지만, 많은 브라우저 뷰어와 휴대폰 미리보기에는 첨부 패널이 없습니다. 데스크톱 리더에서 PDF를 열고 클립 아이콘이나 첨부 패널을 찾아보세요.
- 파일을 둘 이상 첨부할 수 있나요?
- 네. 첨부 필드에서 여러 파일을 선택하면 각각 업로드한 파일 이름의 별도 항목으로 내장됩니다.
- 첨부하면 PDF 페이지가 바뀌나요?
- 아닙니다. 페이지 내용은 그대로입니다. 파일 크기는 첨부 파일 크기만큼 대략 늘어납니다.
- 첨부 파일을 다시 꺼내려면요?
- 뷰어의 첨부 저장 명령을 쓰세요. 바이트가 그대로 저장되어 있으므로 저장된 파일은 처음 업로드한 원본과 같습니다.
- 첨부 파일이 이름과 확장자를 유지하나요?
- 업로드한 파일 이름이 Filespec에 `/F`와 `/UF` 모두로 저장되므로 `budget-2026.xlsx` 같은 이름이 쓴 그대로 나타납니다.
최종 업데이트:
코드에서 호출하기
이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/misc/add-attachments" \
-F "[email protected]" \
-F "attachments=@attachments" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 '첨부 관리' 작업을 대신 실행합니다: /skills/pdf123-add-attachments.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.