KidStory 프로젝트를 진행하던 중 메인 이미지가 의도했던 플랫 파스텔 벡터 일러스트 형태가 아닌, 실사 형태의 어색한 인물 사진처럼 생성되는 버그를 발견했다. 기존에 구축해둔 이미지 생성 자동화 파이프라인에서 스타일이 심각하게 깨지는 문제가 발생한 것이다.
원인을 파악하기 위해 사용 중인 Pollinations.ai의 공식 API 문서인 APIDOCS.md를 샅샅이 확인해보았다. 조사 결과 /prompt/ 엔드포인트에는 네거티브 프롬프트(negative prompt)를 설정할 수 있는 별도의 파라미터가 아예 존재하지 않는다는 사실을 알게 되었다.
1. negative prompt 파라미터 부재와 버그 원인 분석
해당 엔드포인트에서 공식적으로 지원하는 파라미터는 prompt, model, width, height, seed, nologo, enhance, safe가 전부였다. negative prompt 대체 파라미터가 제공되지 않다 보니, 기존 코드에서는 장면 묘사 뒤에 'no realistic human faces' 같은 금지 지시어를 단일 프롬프트 문자열 끝에 덧붙여 호출하고 있었다.
하지만 길게 이어진 장면 설명 뒤쪽에 스타일 금지 지시가 붙다 보니 AI 모델이 스타일 지시 사항을 매우 약하게 반영하는 문제가 발생했다. 더불어 무료 호스팅 특성상 flux라는 모델 이름 뒤에서 작동하는 실제 내부 모델이 예고 없이 변경되는 flux 모델 드리프트 현상까지 겹치면서 실사 사진 형태의 결과물이 출력되었던 것으로 추정했다.
2. 프롬프트 위치 이동과 가중치 강화를 통한 해결
이 문제를 해결하기 위해 KidStory 및 IssueLog 서비스의 generateAndUploadImage() 함수 로직을 즉시 수정했다. 단일 프롬프트 내부에서 스타일 지시 문구의 위치를 맨 뒤에서 맨 앞으로 전면 이동시켰다.
또한 단순히 금지 문구만 적는 것에 그치지 않고 'NOT a photo, NOT photorealistic'이라는 명시적 문구를 프롬프트 최전방에 추가하여 가중치를 대폭 강화했다. Pollinations API 프롬프트 스타일 강제 적용 작업의 핵심은 모델이 전체 텍스트를 읽기 전에 스타일 가이드라인과 금지 사항을 가장 먼저 인식하도록 순서를 바꾸는 것이었다.
3. 실전 적용 결과 및 얻은 개발 교훈
수정된 로직을 적용한 후 이미지를 다시 생성해보니 결과는 매우 성공적이었다. 무작위 실사 사진으로 이탈하던 버그가 깔끔하게 해결되었고, 원래 의도했던 플랫 파스텔 느낌의 벡터 일러스트가 안정적으로 생성되기 시작했다.
이번 경험을 통해 별도의 negative prompt 설정 파라미터가 없는 무료 API 환경에서는 단일 프롬프트 내 지시어의 위치(앞/뒤)를 바꾸는 것만으로도 스타일 반영 속도와 품질이 크게 달라질 수 있다는 점을 배웠다. 아울러 무료 API 기반의 이미지 생성 자동화 노하우를 쌓을 때는 외부 서비스의 flux 모델 드리프트 등 예상치 못한 변수를 항상 고려하고 디버깅할 수 있는 구조를 갖춰야 한다는 귀중한 교훈을 얻었다.