“실패해도 안 죽게” 만든 코드가 버그를 숨겼다: 존재하지 않는 모델 이름과 엉뚱한 AI 영상
텍스트나 사진으로 짧은 영상을 만들어주는 AI 영상 서비스를 운영하고 있습니다. 무료 등급은 집 PC의 GPU에서 오픈소스 모델로 생성합니다. 어느 날 테스트로 “노을 지는 해변에서 파도를 바라보는 강아지”를 입력했는데, 결과물은 글자가 잔뜩 들어간 애니메이션 로봇이었습니다. 강아지도, 해변도, 노을도 없었습니다.
구조부터
무료 등급에서 쓰는 이미지·영상 모델은 영어 설명으로 학습된 모델입니다. 그래서 사용자가 한국어로 입력하면, 먼저 다른 AI 모델(Gemini)로 영어 묘사 문장으로 바꾼 뒤 생성 모델에 넘깁니다.
한국어 입력 → [번역 함수: Gemini] → 영어 프롬프트 → [생성 모델] → 영상
번역 함수는 이렇게 생겼습니다.
def translate_prompt_en(korean_prompt):
try:
resp = client.models.generate_content(model=GEMINI_MODEL, contents=...)
return resp.text.strip()
except Exception:
return korean_prompt # 번역이 실패해도 서비스는 계속
번역이 실패해도 서비스가 멈추지 않도록 원문을 그대로 돌려주는 방어 코드입니다. 선의로 넣은 코드였습니다.
원인: 매번 실패하고 있었는데 아무도 몰랐다
번역 함수를 직접 호출해 봤더니 영어가 아니라 입력한 한국어가 그대로 나왔습니다. except를 잠시 풀고 실제 에러를 보니 이랬습니다.
404 Publisher model ... gemini-3.7-flash was not found
설정 파일의 GEMINI_MODEL 값이 이 프로젝트에서 쓸 수 없는 모델 이름이었습니다. 그러니 번역은 매번 실패했고, 방어 코드는 매번 조용히 한국어 원문을 돌려줬습니다. 영어로 학습된 생성 모델은 한국어 문장을 거의 이해하지 못하니, 사실상 무작위에 가까운 결과가 나온 겁니다. 로봇 그림 속 이상한 글자들은 모델이 한글을 “글자가 있는 그림”으로 받아들인 흔적으로 보였습니다.
핵심은 이 버그가 겉으로 전혀 드러나지 않았다는 점입니다. 에러 로그도 없고, 서비스는 정상 응답하고, 영상도 만들어졌습니다. 품질이 좀 이상할 뿐이었습니다.
고친 방법
이 프로젝트와 리전에서 실제로 호출되는 모델 이름을 하나씩 시험해 봤습니다.
| 모델 이름 | 결과 |
|---|---|
| gemini-3.7-flash (기존 설정) | 404 |
| gemini-2.0-flash-001 | 404 |
| gemini-2.5-flash-001 | 404 |
| gemini-flash-latest | 404 |
| gemini-2.5-flash | 정상 |
설정값을 동작하는 이름으로 바꾸고 컨테이너를 재시작한 뒤 같은 문장으로 다시 생성했더니, 이번엔 노을 진 해변에서 파도를 보는 강아지가 정확히 나왔습니다.
사실 기존 설정의 모델 이름은 제 다른 시스템에서 잘 쓰고 있던 이름이라 의심조차 하지 않았습니다. 호출하는 위치(리전) 설정이 서로 달랐던 것으로 보입니다. 모델 이름은 프로젝트, 리전, 시기에 따라 쓸 수 있는 게 다릅니다. 문서에 있는 이름이라도 내 환경에서 되는지는 직접 호출해 봐야 압니다.
방어 코드를 어떻게 바꿔야 할까
“실패해도 계속”이라는 방어 자체는 틀리지 않았습니다. 번역 서비스가 잠깐 불안정하다고 영상 생성 전체가 멈추는 것보다는 낫습니다. 문제는 실패를 아무 흔적 없이 삼킨 것이었습니다.
def translate_prompt_en(korean_prompt):
try:
...
return resp.text.strip()
except Exception as e:
log.warning("번역 실패, 원문 사용: %s", e) # 최소한 흔적은 남긴다
return korean_prompt
이렇게 경고 로그 한 줄만 있었어도, 로그를 한 번 봤을 때 같은 경고가 매번 찍히는 걸 보고 바로 알았을 겁니다.
배운 것
- 폴백(대체 경로)이 있는 기능은 “정상 경로가 실제로 동작하는지”를 따로 확인해야 합니다. 폴백이 잘 작동할수록 정상 경로의 고장은 더 잘 숨습니다.
- except에서 아무것도 남기지 않는 코드는 경고 로그라도 남기게 바꿉니다.
- 모델 이름을 바꾸면 그 모델을 쓰는 함수를 직접 호출해 결과를 눈으로 봅니다. 그래서 모델 설정을 바꿀 때는 번역 함수를 직접 불러 영어 문장이 나오는지 확인하기로 했습니다.
에러로 멈추는 버그는 금방 고칩니다. 오래 가는 버그는 멈추지 않고, 조금 이상한 결과만 내는 버그입니다.