OpenAI Python SDK에 내 컴퓨터 파일을 어떻게 올리나요? 초보자 Path 업로드 방법

Path 객체
Python이 로컬 파일의 위치를 다루는 객체입니다. 파일 내용 자체나 서버 ID는 아닙니다.

file
SDK 업로드에 전달하는 파일 입력입니다. 여기서는 Path 객체를 넣습니다.

file_id
업로드 뒤 받은 id를 다른 API에서 참조할 때 씁니다. 로컬 경로를 대신 적지 않습니다.

1단계. 실행 위치와 파일을 확인합니다.
from pathlib import Path 뒤에 path = Path("sample.txt") 를 둡니다. 같은 프로그램에서 Path.cwd() , path.resolve() , path.is_file() 을 확인하세요. 경로가 의도한 시험 파일인지 직접 대조합니다. 파일이 아니거나 접근 오류가 나면 전송을 멈추세요.

2단계. 확인한 Path 객체로 한 번 업로드합니다.
공식 SDK의 기존 인증 설정을 사용해 from openai import OpenAI 와 client = OpenAI() 를 준비합니다. 이어 uploaded = client.files.create(file=path, purpose="user_data") 를 호출하세요. 실제 키를 코드에 적지 말고 승인된 비밀 설정에서 불러옵니다.

3단계. 반환 정보와 다음 작업을 구분합니다.
uploaded.id , uploaded.filename , uploaded.purpose 를 대조하세요. uploaded.bytes 가 제공되면 크기도 비교하고, null이면 0으로 바꾸지 않습니다. 모델에게 읽히려면 별도 Responses 요청의 input_file 에서 file_id 에 받은 id를 넣습니다.

위험 신호 1
문서 예제의 파일명이 같다는 이유로 다른 폴더의 파일을 올립니다. 실행 위치와 실제 경로를 먼저 확인하세요.

위험 신호 2
업로드 성공을 분석 완료로 표시합니다. 모델 입력에는 별도 형식·크기·모델 조건이 있으므로 다음 요청의 제한을 따로 확인하세요.

위험 신호 3
로컬 파일이므로 기기 안에서만 처리된다고 생각합니다. 파일 내용이 API로 전송되며, 경로·파일명에도 개인정보가 있을 수 있으니 공개 로그에 남기지 마세요.

사용법은 공식 웹 문서에서

Python API library의 File uploads와 Upload file의 입력 항목을 함께 읽으세요. Path 객체를 쓰는 SDK 예시와 원시 HTTP 요청을 섞지 않습니다.

경로 확인은 API 개발 환경에서

실제로 요청하는 Python 프로그램에서 경로를 확인하세요. 노트북·서버가 내 PC와 같은 파일을 본다고 가정하지 않습니다. ChatGPT 앱의 첨부 버튼은 이 코드의 경로 설정이 아닙니다.