AI 초보자 QnA
질문
OpenAI API에 PDF를 URL로 바로 읽힐 수 있나요?
답변
네. Responses API에서는 input_file의 file_url에 외부 PDF 주소를 넣어 보낼 수 있습니다. 파일을 Files API에 먼저 올린 뒤 ID를 받는 절차가 항상 필요한 것은 아닙니다.
다만 Chat Completions는 외부 파일 URL 입력을 지원하지 않습니다. 이 글은 API의 PDF 전달 방식을 다룹니다. ChatGPT 대화창에 링크를 붙이는 방법이나 긴 논문을 요약하는 요령과는 구분하세요.
짧게 답하면
API 종류 확인 → PDF 접근·전송 권한 확인 → 전달 방식 선택 → 작은 요청으로 결과 대조 순서로 진행하세요. URL, 업로드 ID, 파일 데이터를 서로 다른 입력 방식으로 이해하면 됩니다.
file_url
외부 파일 주소를 전달합니다. Responses API에서 PDF를 보내는 방법 중 하나입니다.
file_id
Files API로 올린 파일의 식별자를 전달합니다. 파일 이름이나 내 컴퓨터 경로와는 다릅니다.
file_data
Base64로 인코딩한 파일 데이터를 요청에 넣습니다. 단순히 파일명을 적는 방식이 아닙니다.
처음 쓰는 사람 기준으로 설명하면
웹에 공개된 보고서 PDF를 분석한다고 가정해 보세요. 공식 File inputs 가이드는 외부 PDF 주소를 file_url로 보내는 예시를 제공합니다. 주소를 일반 질문 문장에만 적는 대신 파일 입력 항목으로 지정하고, 어떤 내용을 찾을지는 input_text에 따로 적습니다.
내 컴퓨터에만 있는 문서는 파일 업로드 방식을 고를 수 있습니다.
client.files.create
로 올리고 반환된 id를 input_file의 file_id에 넣습니다. 공식 가이드는 모델 입력용 파일의 purpose로
user_data
를 권장합니다. 업로드만 마쳤다고 분석 답변까지 생성된 것은 아닙니다.
PDF의 글과 페이지 이미지를 함께 처리하려면 비전 기능이 있는 모델이 필요합니다. 공식 문서의 직접 파일 입력 제한은 파일 하나당 50 MB 미만, 한 요청의 파일 합계는 50 MB입니다. Files API의 일반 업로드 상한인 512 MB를 PDF 분석 요청 한도로 적용하지 마세요.
한 줄 정리: PDF 주소, 업로드한 파일의 ID, 인코딩한 데이터 중 내 상황에 맞는 방식을 고르고 해당 API가 지원하는지 확인하세요.
바로 따라 해보기
1단계. 시험 PDF와 요청 경로를 확인합니다.
전송해도 되는 작은 공개 PDF를 고릅니다. 주소가 로그인 화면이나 문서 미리보기 페이지가 아니라 원하는 PDF를 가리키는지 확인하세요. 회사 자료를 시험하려고 공개 링크로 바꾸지 않습니다. 요청 경로는
POST /v1/responses
인지 봅니다.
2단계. 파일 항목과 질문을 함께 보냅니다.
사용 가능한 비전 모델을 선택한 뒤 user 메시지의 content 안에
type="input_file"
과 file_url을 넣습니다. 별도 input_text에는 확인할 항목을 적으세요. 예를 들어 문서 제목과 첫 페이지의 핵심 내용을 요청합니다. API 키는 코드에 직접 적지 않습니다.
3단계. 답변을 원본 PDF와 대조합니다.
제목과 첫 페이지 내용이 같은 파일을 가리키는지 확인하세요. 오류가 나면 주소 접근, 파일 크기, 모델과 API 종류부터 봅니다. 접근 제한이 있는 자료는 권한을 풀기보다 업로드나 file_data 사용을 검토하고 원문 제공 권한도 확인합니다.
주의할 점
URL로 보내도 파일 내용이 외부 API에서 처리됩니다. OpenAI는 API 데이터의 모델 학습 사용 여부와 저장·악용 모니터링 로그를 따로 설명합니다. 직접 업로드하지 않았다는 이유로 아무 데이터도 전송·보관되지 않는다고 생각하면 안 됩니다.
Chat Completions 예제에 file_url만 추가합니다. 외부 파일 URL은 지원되지 않으므로 API별 입력 표와 요청 구조를 먼저 확인하세요.
PDF 파일 용량만 보고 비용도 작다고 판단합니다. PDF는 추출한 글과 페이지 이미지가 함께 입력에 들어가 토큰 사용량이 늘 수 있습니다.
주소를 읽지 못하면 비공개 문서를 누구나 열 수 있게 바꿉니다. 자료의 접근 제한은 유지하고 허용된 전달 방식을 선택하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
지원 방식 확인은 공식 웹 문서
File inputs의 입력 방식 표와 File URLs 예시를 나란히 읽으세요. URL 방식과 Files 업로드 방식을 구분하고, PDF 원문도 별도 창에 열어 답변을 대조할 준비를 합니다.
실제 요청은 API 개발 환경
키를 안전하게 불러오는 프로그램에서 작은 파일 한 개부터 시험하세요. ChatGPT 모바일 앱의 첨부 버튼으로 API 요청 형식이 맞는지 검증할 수는 없습니다. 한 번 성공한 뒤에도 중요한 숫자와 표는 원문에서 확인합니다.
같이 보면 좋은 질문
확인한 공식 자료
OpenAI 공식 가이드 — File inputs — API별 URL·파일 ID·Base64 지원, PDF 모델 조건과 직접 입력 용량 제한을 확인했습니다.
OpenAI API 문서 — Upload file — 별도 파일 업로드 경로와 반환되는 파일 ID, 일반 업로드 상한을 확인했습니다.
OpenAI 공식 가이드 — Data controls — API 데이터의 학습 사용과 기능별 저장, 악용 모니터링 로그의 구분을 확인했습니다.
