모델 ID(Model ID)는 택배 송장에 적는 정확한 주소 같은 것 — "오퍼스"처럼 부르는 별명이 아니라 시스템이 AI 모델을 정확히 찾아 호출할 수 있도록 정해진 고유 식별 이름이에요.
모델 ID는 택배 송장에 쓰는 정확한 주소와 비슷해요. 친구끼리는 "우리 동네 빵집"이라고 해도 통하지만, 택배 기사에게는 도로명과 번지까지 정확히 적어야 물건이 도착해요. AI 모델도 사람끼리는 "오퍼스", "소넷"이라고 부르지만, 프로그램이 모델을 호출할 때는 공급사 이름과 모델명, 버전이 들어간 정확한 식별 문자열을 써야 해요.
강의에서는 스레드 글 자동 게시와 댓글 자동화를 만들 때 이 문제를 직접 만나요. 에이전트 설정 파일에 사용할 모델을 등록하는데, "Opus"처럼 부르는 이름만 적으면 인식하지 못하고 "공급사/모델명-버전" 형태의 정확한 이름을 넣어야 해요. 이름이 한 글자라도 틀리면 unknown model 오류로 실패하고, 크론으로 예약해 둔 작업도 그대로 멈춰요. 그래서 "unknown model 오류는 왜 나나요?"에 대한 답은 대부분 "설정에 적은 모델 ID가 실제 이름과 다르기 때문"이에요. 공급사 공식 문서나 콘솔의 모델 목록에서 그대로 복사해 넣는 게 가장 안전해요.
주의할 점은 모델 ID가 시간이 지나며 바뀐다는 거예요. 새 버전이 나오면 이름이 달라지고, 오래된 모델은 사용이 중단되기도 해요. 그래서 잘 돌던 자동화가 어느 날 갑자기 실패하면 모델 ID가 아직 유효한지부터 확인해 보세요. 별칭(alias)은 사람이 기억하기 쉬운 짧은 이름이고, 모델 ID는 시스템이 실제로 찾는 정식 이름이라는 차이도 알아 두면 좋아요.
AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.