AI 초보자 QnA
질문
OpenAI API에 올린 파일은 어떻게 확인하고 지우나요?
답변
OpenAI Files API로 올린 파일은 목록 조회 → 파일 ID 확인 → 개별 정보 조회 → 삭제 순서로 정리합니다. 파일 이름만 보고 지우지 말고 API 응답의 id를 기준으로 대상을 고르세요.
이 글은 코드나 자동화에서 Files API로 업로드한 파일을 다룹니다. ChatGPT 대화창의 첨부 파일이나 Library 정리와는 별도입니다. 삭제하면 연결된 모든 벡터 저장소에서도 제거되므로 사용 중인 검색 자료인지 먼저 확인하세요.
짧게 답하면
GET으로 목록과 정보를 읽기 → 사용처 확인하기 → 필요 없는 파일 하나만 DELETE → 결과 다시 조회하기가 기본입니다. 처음에는 조회까지만 연습하고 운영 자료를 한꺼번에 지우지 않습니다.
List files
GET /v1/files로 파일 목록을 읽습니다. 이름, ID, 용도를 확인하는 출발점입니다.
Retrieve file
GET /v1/files/{file_id}로 선택한 파일 한 개의 정보를 확인합니다. 본문 다운로드와는 다릅니다.
Delete file
DELETE /v1/files/{file_id}로 해당 파일을 지웁니다. 같은 경로여도 GET과 동작이 다릅니다.
처음 쓰는 사람 기준으로 설명하면
API로 파일을 올리면 응답에 파일 식별자인 id가 생깁니다. filename은 이름, bytes는 파일 크기, purpose는 용도입니다. 이름이 같아 헷갈릴 때는 ID와 업로드 시각인 created_at을 함께 대조하세요.
목록에서 보고 싶은 용도가 정해져 있다면 purpose로 걸러 볼 수 있습니다. 다만 필터를 걸었거나 일부만 조회한 목록에서 파일이 안 보인다고 삭제됐다고 판단하면 안 됩니다. has_more가 true이면 다음 목록이 남아 있고, last_id를 다음 요청의 after 값으로 넣어 이어서 확인합니다.
개별 정보 조회는 파일 내용 전체를 내려받는 기능이 아닙니다. 문서의 Retrieve file은 파일 정보를, Retrieve file content는 내용을 반환합니다. 삭제 대상을 확인할 때는 먼저 정보만 읽고, 필요한 원본이 따로 보관돼 있는지도 확인하세요.
한 줄 정리: 파일 이름으로 후보를 찾되, 실제 조회와 삭제는 파일 ID로 한 건씩 처리합니다.
바로 따라 해보기
1단계. 파일 목록을 읽습니다.
업로드에 사용한 프로젝트와 인증 설정을 확인한 뒤 공식 문서의 GET /v1/files 요청으로 목록을 조회하세요. 응답에서 id, filename, purpose를 적고 다음 페이지가 남았는지도 봅니다. API 키 값은 기록하지 않습니다.
2단계. 지울 파일 한 개를 다시 확인합니다.
목록에서 받은 ID를 {file_id} 자리에 넣어 GET /v1/files/{file_id}로 조회합니다. 파일명·크기·용도가 맞는지 확인하고, 해당 파일을 쓰는 자동화나 검색 기능의 담당자에게 삭제해도 되는지 확인하세요.
3단계. 삭제 응답과 목록을 대조합니다.
버려도 되는 시험 파일만 골라 같은 경로에 DELETE 요청을 보냅니다. 응답의 id가 대상과 같고 deleted가 true인지 확인하세요. 이어 동일한 프로젝트에서 목록을 다시 읽어 해당 ID가 남아 있는지 확인합니다.
주의할 점
Delete file은 파일을 모든 벡터 저장소에서도 제거합니다. 벡터 저장소는 AI가 검색에 쓸 자료를 모아 둔 공간이므로, 테스트 자료로 보이더라도 다른 검색 기능이 참조 중이면 답변에 영향을 줄 수 있습니다.
파일 이름만 같다고 운영 자료를 삭제합니다. 업로드 시각, 용도, 파일 ID와 실제 사용처를 함께 대조하세요.
목록 첫 페이지에 없다는 이유만으로 삭제가 끝났다고 봅니다. 필터와 다음 페이지 여부를 확인하세요.
삭제 응답만 보고 다른 서비스의 사본과 로그까지 모두 지워졌다고 단정합니다. 별도로 복사한 자료는 그 저장 위치에서 관리하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
문서 확인은 웹사이트부터
공식 Files 문서에서 List, Retrieve, Delete를 나란히 읽으세요. 요청 방식과 file_id의 역할을 이해한 뒤 조회부터 시작하면 삭제 요청을 잘못 보내는 실수를 줄일 수 있습니다.
실제 정리는 API 도구·개발 환경
Files API를 호출하는 프로그램이나 API 도구에서 진행합니다. ChatGPT 모바일 앱의 대화를 지우는 것으로 대신하지 마세요. 키를 노출하지 않는 환경에서 시험 파일 한 개만 다룹니다.
확인한 공식 자료
OpenAI API 공식 문서 — Files — 목록의 파일 정보, purpose 필터와 after·has_more를 이용한 다음 페이지 확인 방법을 확인했습니다.
OpenAI API 공식 문서 — Retrieve file — 파일 ID로 개별 파일 정보를 읽는 경로와 반환 항목을 확인했습니다.
OpenAI API 공식 문서 — Delete file — 삭제 요청 방식, 모든 벡터 저장소에서의 제거와 deleted 응답을 확인했습니다.
감자나라 AI 강의보기 5,000 
