본문 바로가기
C.W.K.
Stream
Lesson 07 of 08 · published

API Versioning 과 모델 pinning

~22 min · versioning, deprecation, model-pins

Level 0Tokenizer
0 XP0/54 lessons0/10 achievements
0/120 XP to next level120 XP to go0% complete

OpenAI 모델 이름에는 두 가지 형태가 있어. gpt-4.1 같은 rolling pointer 는 새 snapshot 이 나오면 그쪽을 가리킬 수 있고, gpt-4.1-2025-04-14 같은 날짜 버전은 특정 snapshot 을 고정해서 가리켜. rolling 이름은 별도 알림 없이 동작이 달라질 수 있어.

운영 환경은 날짜 버전으로 고정해

운영 환경에서는 날짜가 붙은 모델을 써야 재현 가능한 동작을 기대할 수 있어. 개발 환경에서는 rolling 이름도 함께 시험해서 변화를 일찍 찾아. CI 에 날짜 없는 모델 이름을 막는 검사를 넣으면 실수로 rolling 이름이 운영 코드에 들어가는 걸 예방할 수 있어.

지원 종료 공지를 놓치지 마

오래된 모델은 보통 지원 종료 12 개월 이상 전에 공지가 올라와. 하지만 changelog 를 읽지 않으면 그 시간도 없는 셈이야. RSS 를 구독하거나 매주 자동으로 deprecation 목록을 확인해. 운영 중인 모델이 목록에 오른 날부터 바로 교체 계획을 시작해.

External links

Exercise

운영 코드에서 날짜가 붙지 않은 모델 이름을 사용하면 빌드를 실패시키는 CI 검사를 작성해. model="gpt-* 패턴을 찾고, 운영 경로에서는 날짜 suffix 를 반드시 요구하도록 만들어.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.