AI 초보자 QnA
질문
OpenAI API에서 사용할 수 있는 모델은 어떻게 확인하나요?
답변
내 API 키로 GET /v1/models를 호출하면 현재 조회되는 모델과 각 모델의 정확한 ID를 확인할 수 있습니다. 이 ID를 API 요청의 model 값에 그대로 넣습니다.
다만 목록에 보인다는 사실만으로 내 작업에 알맞다는 뜻은 아닙니다. 공식 모델 카탈로그에서 입력 형식과 지원 도구를 살피고, 지원 종료 문서에서 교체 예정 모델인지 한 번 더 확인하세요.
짧게 답하면
모델 목록 조회 → model ID 복사 → 모델 카탈로그에서 용도 확인 → 지원 종료 일정 확인 → 작은 요청으로 시험 순서가 안전합니다. 블로그나 예제 코드에 적힌 오래된 이름을 바로 복사하지 마세요.
목록 조회
내 인증 정보로 현재 조회되는 모델 ID를 확인합니다.
기능 확인
텍스트·이미지·음성 입력과 도구 지원 등 작업에 필요한 조건을 비교합니다.
종료 일정
Deprecated·Legacy 표시와 종료일, 권장 대체 모델을 확인합니다.
처음 쓰는 사람 기준으로 설명하면
모델 이름은 사람이 읽는 제품 설명과 API가 받는 model ID로 나눠 생각하면 쉽습니다. 코드에는 비슷해 보이는 표시 이름이 아니라 공식 문서나 목록 응답에 나온 ID를 정확히 넣어야 합니다. 하이픈, 숫자, 접미사를 임의로 고치면 다른 모델을 가리키거나 요청이 실패할 수 있습니다.
공식 List models 문서는 GET /models가 현재 이용 가능한 모델을 나열하고, 각 항목의 id를 API 엔드포인트에서 참조할 수 있다고 설명합니다. 응답의 owner나 생성 시각은 기본 정보이며, 어떤 입력을 받고 어떤 도구를 지원하는지는 모델 카탈로그에서 따로 확인하는 편이 정확합니다.
모델은 계속 추가되거나 교체됩니다. Deprecations 문서에 종료가 예고된 모델은 당장 조회되더라도 새 작업의 기본값으로 고정하지 말고, 권장 대체 모델을 시험한 뒤 바꾸세요. 특히 preview 표시가 있는 모델은 짧은 공지 뒤 종료될 수 있어 업무용 자동화에서는 교체 계획이 필요합니다.
한 줄 정리: 목록은 “지금 보이는 모델”, 카탈로그는 “무엇에 쓰는 모델”, 지원 종료 문서는 “언제 바꿔야 하는 모델”을 알려 줍니다.
바로 따라 해보기
1단계. API 키를 환경 변수로 준비합니다.
키를 코드와 명령문에 직접 적지 말고 OPENAI_API_KEY 같은 환경 변수에서 불러오세요. 화면 공유, 오류 캡처, 저장소에는 키 값을 남기지 않습니다.
2단계. 모델 목록을 한 번 조회합니다.
터미널에서 아래 요청을 실행하고 data 배열 안의 id를 확인합니다.
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"3단계. 후보 ID를 공식 문서와 대조합니다.
모델 카탈로그에서 용도, 입력·출력 형식, 지원 도구와 사양을 읽습니다. 이어 Deprecations 문서에서 같은 ID나 모델 계열의 종료 공지가 있는지 찾고, 작은 테스트 요청으로 결과와 비용 기록을 남기세요.
주의할 점
모델 목록 응답은 추천 순위표가 아닙니다. 목록에 있는 ID를 무조건 최신·최고 모델로 해석하지 말고 실제 작업 조건과 공식 사양을 함께 보세요.
API 키를 URL, 코드 저장소, 메신저나 캡처 화면에 그대로 남깁니다. 노출이 의심되면 즉시 키를 폐기하고 새 키로 바꾸세요.
model ID의 철자나 접미사를 보기 좋게 고칩니다. 식별자는 공식 응답에 나온 값을 그대로 보존해야 합니다.
지원 종료가 예고된 모델을 새 자동화에 고정합니다. 종료일 전에 대체 모델로 결과 형식과 품질을 비교하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
공식 문서는 웹사이트부터
모델 카탈로그, API Reference, Deprecations를 나란히 열어 보기 쉽습니다. 처음에는 웹에서 ID와 지원 조건을 확인한 뒤 복사하세요.
실제 조회는 개발 환경에서
모바일 앱보다 터미널이나 API 도구가 알맞습니다. 실제 앱이 쓰는 프로젝트와 같은 인증 정보로 조회해야 환경 차이를 줄일 수 있습니다.
같이 보면 좋은 질문
확인한 공식 자료
List models | OpenAI API Reference — GET /models가 현재 이용 가능한 모델과 API에서 참조할 id 등 기본 정보를 반환하는 것을 확인했습니다.
Models | OpenAI API — 모델 ID와 기능, 입력·출력 방식, 도구 지원, 사양을 비교하는 공식 카탈로그를 확인했습니다.
Deprecations | OpenAI API — 지원 종료가 발표된 모델의 종료일과 권장 대체 모델, 공지 기준을 확인했습니다.
