영상 프롬프트 작성 누락 방지를 위한 간단한 Lint를 Python으로 구현하기: Draft 모드 제출 전 체크
요약
AI 영상 프롬프트 작성 시 필수 요소 누락을 방지하기 위해 Python 기반의 간단한 Lint 도구를 구현했습니다. 이 린터는 Wan 3.0 Draft Mode를 상정하며, 카메라 지시나 빛 묘사 등 핵심 구성요소의 유무를 기계적으로 확인합니다. 이를 통해 여러 드래프트를 비교할 때 프롬프트의 세밀함(granularity)을 일정하게 유지하여 작업 효율성을 높일 수 있습니다.
핵심 포인트
- Python Lint 스크립트로 필수 요소 누락 여부를 체크 가능
- 카메라, 빛 등 4가지 핵심 요소를 키워드 기반으로 검증
- 여러 드래프트 비교 시 프롬프트의 일관성을 유지하는 데 효과적
- 팀원들과 규칙을 공유하여 작업 낭비를 줄이는 데 적합함
AI 영상을 여러 번 드래프트(draft)할 경우, '카메라 지시가 빠졌다', '빛에 대한 묘사가 없다'와 같은 누락 요소 때문에 한 번을 낭비하는 경우가 생깁니다. 드래프트는 비용이 낮다고 해도 비교의 기준이 흔들리는 것은 곤란합니다. 그래서 프롬프트를 제출하기 전에 필수 요소의 유무만을 기계적으로 확인하는 작은 lint를 만들었습니다. 대상은 Wan 3.0의 Draft Mode를 상정하고 있습니다.

참고 페이지 요약: wan30.io/ja/draft-mode (2026-10-31 조회)
페이지에 따르면, 드래프트 모드는 고정된 드래프트 워크스페이스에서 프롬프트, 카메라 움직임, 종횡비(aspect ratio), 참조 이미지를 테스트하는 곳입니다. 생성 전에는 정확한 크레딧 견적이 표시되며, 좋은 방향성은 Full Generator로 가져갈 수 있습니다. 또한 사용법 페이지에서는 드래프트 모드가 1~15초 분량의 영상을 480p / 720p / 1080p 해상도로 텍스트 및 이미지로부터 생성할 수 있다고 정리되어 있습니다.
즉, '많이 테스트하고 비교'하기 위한 장소입니다. 비교를 하려면 각 프롬프트가 같은 수준의 세밀함(granularity)으로 작성되어야 합니다.
사용법 페이지에는 프롬프트는 촬영자에게 주는 지시로, '누가 어디서 무엇을 하는지 작성하고 빛, 카메라, 분위기를 더한다'는 생각이 적혀 있습니다. 이를 4가지 요소로 나누어 키워드로 유무를 판별합니다.
import re, sys
RULES = {
"카메라": r"カメラ|寄る|引く|追う|パン|ズーム|ドリー|俯瞰|ローアングル|固定",
...
1행 1프롬프트의 텍스트 파일을 전달하면, 줄마다 OK/NG와 이유를 출력합니다. 키워드는 본인의 작성 스타일에 맞춰 추가해 주세요. 정규 표현식(regular expression)이라 완벽하지는 않지만, '누락'을 잡아내기에는 충분합니다.
#1 OK 비가 그친 석조 포장길 골목에서, 흰 스니커즈를 신은 남성이 물웅덩이에...
#2 NG 느낌 좋은 상품 영상...
- 카메라에 대한 기술이 발견되지 않음
...
lint를 통과한 프롬프트를 드래프트 모드에서 생성하고 비교할 때는 1요소만 변경합니다. 예를 들어, 카메라만 '낮은 위치에서 추적' 또는 '고정으로 뒤로 물러나기(pull back)'로 바꾸고 나머지는 그대로 둡니다. 좋은 방향을 찾았다면, 그 설정을 Full Generator에 가져갑니다.
구도나 움직임의 자연스러움은 실제로 생성해 보지 않으면 알 수 없습니다. lint는 어디까지나 '비교 가능한 상태의 프롬프트'를 갖추기 위한 입구이며, 판단 자체는 드래프트 영상으로 진행합니다.
드래프트를 많이 돌릴수록 프롬프트의 세밀함을 맞추는 것이 효과가 큽니다. 수십 줄 분량의 lint만으로도 작성 누락에 의한 낭비 작업은 줄일 수 있으므로, 팀원들과 같은 규칙을 공유하는 데에도 적합합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기