영상 생성기은(는) 무엇을 하나요?
포르투갈어로 응답하세요. 화면 텍스트와 내레이션은 전문 용어 없이 작성합니다. 새 영상을 시작하기 전에 docs/04_VIDEO_ANIMADO.md (애니메이션) 또는 docs/01 및 docs/02 (튜토리얼), 그리고 docs/03_QUALIDADE_E_CHECKLIST.md를 읽으세요.
애니메이션 영상 흐름 (가장 많이 요청됨)
- 대본 승인. 대본이 없으면
roteirista스킬을 사용하여 사용자에게 대본 + 스토리보드를 보여준 후 녹화하세요. - 템플릿 복사:
videos/exemplo-bolinha-vermelha→videos/<영상-짧은-이름>(새 폴더, 예제는 절대 변경하지 마세요). - roteiro.py:
FALAS(한 개의 대사 = 한 개의 장면,cena="이름"),MARCA(채널 이름, 아바타), 그리고 필요하면PERSONAGEM(포즈 PNG가 있는 폴더)을 교체하세요.saida와saida_so_voz도 조정하세요. - pagina.html: 각 장면에 대해
MONTA에 등록된cNome(r, c)함수를 만드세요. 템플릿의 구성 요소를 재사용하세요:quando(cena, "단어")(음성이 단어를 말하는 순간),entra()(동기화된 등장),sai(),anim(),personagem()(정확한 단어에서 포즈 변경; 손에 든 물체는.extra로),bola()/bolaDiv(),jardim(),cachorro(),som(), 마지막 카드 (montarFim) 및 썸네일 (montarCapa,render(t < 0)에서 그림). 색상은--fundo,--tinta,--destaque에서. - 전체 녹화 전 확인:
py motor/animar.py videos/<폴더> --fotos 0,3,8,15(실제 해상도의 PNG가saida/fotos에 생성됨)를 실행하여 장면별로 확인할 시트를 만드세요. 사운드 포함 테스트:--ate 12. - 녹화:
py motor/animar.py videos/<폴더>를 실행하세요. 음악이 포함된 MP4, "음성만" 버전, 그리고saida/controle_de_qualidade.json(자동 QA: 해상도, FPS, 1초 이상 정지 이미지, 반복 프레임, 검은 화면, 볼륨 -14 LUFS, 피크)이 생성됩니다. - 썸네일:
py ferramentas/capa.py videos/<폴더>→saida/Capa.png. - 텍스트 확인:
py ferramentas/verificar_textos.py videos/<폴더>(잘리거나, 화면 밖으로 나가거나, Instagram 버튼 아래에 있는 텍스트 확인). - 파일 경로를 전달하고 사용자가 듣고 확인해야 할 사항을 알려주세요 (당신은 오디오를 듣지 못합니다). 절대 게시하지 마세요.
- 사전 게시 (선택 사항, QA 통과 후): 차원별 편집 QA (
py creative-intelligence/ci.py avaliacao modelo ...), 버전 간 훅 비교 (ci comparar) 및 예측 평가 (Higgsfield)는 비용 승인 및 자료 소유자의 허가를 받은 경우에만 가능합니다 (ci prever ... --modelo-autorizacao).engenharia-reversa스킬의 섹션 5를 참조하세요. 녹화나 튜토리얼에 필수 사항이 아닙니다. 엔진은 이에 의존하지 않습니다.
프레임 시트 (2초 간격): ffmpeg -i saida/<비디오>.mp4 -vf "fps=1/2,scale=240:427,tile=9x3" -frames:v 1 folha.png.
튜토리얼 모드 (실제 웹 페이지)
modelos/roteiro_modelo.py를 videos/<폴더>/roteiro.py로 복사하세요. 작업은 docs/02_ACOES_DO_ROTEIRO.md를 참조하세요.
테스트: py motor/gravar.py videos/<폴더> --so 02-04; 그 다음 전체 영상을 녹화하세요.
비용이 많이 들었던 규칙 (반복하지 말 것)
render(t)는 오직t에만 의존합니다 (이전 프레임에서 저장된 값 없음); 그라데이션 정지는 항상 순서대로.- 절대 멈추지 않기: 카메라는 항상 움직입니다 (느린 줌 + 표류); 끝난 클립은 뒤에서 앞으로 재생; 마지막 카드도 움직입니다.
- 첫 프레임에 액션: 첫 1초에 이미 미스터리를 보여줍니다 (빈 장면이 기다리지 않음).
- Reels (1080 × 1920): 제목은 150~440 px 사이; 자막은 약 1330 px에 최대
16자 (860 px 제한); 1600 px 아래 또는 오른쪽 (x > 960) 11001750 px 사이에는 중요한 요소를 배치하지 마세요 — Instagram 버튼 및 설명 영역. - 시연 대상은 크게 배치: 카메라를 가까이 당기세요; 잔디/앞 요소는 대상물 아래쪽에만.
- "전 × 후" 비교는 두 프레임에서 동일한 구도; 그 사이에 눈에 띄는 전환 (예: 와이프).
- 세로 영상에서 중간에 가로 띠를 넣지 마세요; 가로 클립은 세로로 잘라서 사용 (최대 확대 ~1.2배).
- 캐릭터 PNG: 배경이 진짜 투명한지 확인하세요 (5% 색상이 영상에서 사각형으로 보입니다).
- 의도적인 줌은 0.5초 미만으로 텍스트를 화면 밖으로 밀어낼 수 있습니다. 그 외에는 텍스트 검사기가 깨끗해야 합니다.
- 브라우저 screencast나 Playwright 비디오를 사용하지 마세요 (흐릿하게 나옵니다). 엔진이 프레임 단위로 촬영합니다.
roteiro.py의 Windows 경로는 항상r"..."형식으로.- 음성: 짧은 문장;
vozes.py는 숨 쉴 시간을 두고 (voz["respiro"]) 문장별로 생성합니다. 자연스러운 속도 2.4~3.2 단어/초 (엔진이 지속 시간을 표시합니다: 단어 ÷ 초). - 스톡 이미지 클립: 사용을 허락하는 라이선스만 (Mixkit "Free"; "Restricted"는 광고 금지);
midia/CREDITOS.md에 기록.
보안
- 음성은 외부 서비스(Edge TTS 또는 ElevenLabs)로 전송됩니다: 대본에 이름, CPF, 고객 데이터를 절대 넣지 마세요.
- 키는 오직
~/.secrets/에만 저장 (ElevenLabs:~/.secrets/elevenlabs/.env); 절대 출력하지 않고, 저장소에 복사하지 마세요. - 시뮬레이션이나 가상 캐릭터: 화면에 표시 ("근사 시뮬레이션", "가상 캐릭터").
- 사용자 승인 없이 유료 API 크레딧을 사용하지 마세요.