애니메이션 스튜디오
5단계 파이프라인. 각 단계는 프로젝트 폴더에 자체 파일을 기록하고 사용자가 승인한 후에만 진행됩니다. 크레딧을 사용하기 전에 승인을 건너뛰지 마십시오.
videos/<slug>/
01-tema.md 주제, 시놉시스, 세계관, 대상, 장르
02-roteiro.md 캐릭터, 배경, 상세 장면
03-direcao.md 스타일, 캐릭터 시트, 장면별 프롬프트
projeto.json montar.py가 읽는 매니페스트 (04, 05단계)
04-legendas/ narracao/cena-NN.m4a, legendas.srt, legendas.ass
05-render/ keyframes/, cenas/cena-NN.vK.mp4, norm/, final.mp4
기존 프로젝트 재개: 폴더의 파일을 읽고 누락된 단계부터 계속 진행합니다.
설치 (한 번만)
스킬은 Flow 서버를 자체적으로 포함합니다(<SKILL_DIR>/flow-mcp, 이미 포르투갈어 레이블 포함). Claude에 flow_* 도구가 없으면 다음을 실행하십시오:
python "<SKILL_DIR>/scripts/instalar.py"
Node 22+와 ffmpeg가 PATH에 있어야 합니다. 스크립트는 npm ci를 실행하고, 컴파일한 후 flow 서버를 Claude Code, Codex 및 OpenCode에 등록합니다(PATH에서 찾은 모든 CLI; --alvo codex 등으로 강제 지정 가능). 그런 다음 flow-mcp 내에서 npm run login을 실행하고(Google에 한 번 로그인), Flow에서 프로젝트를 열고 에이전트를 다시 시작합니다.
시작하기 전에
flow_status.hint가 반환되면(예: Flow에서 열린 프로젝트 없음), 사용자에게 알리고 기다리십시오. 열린 프로젝트 없이는 아무것도 생성되지 않습니다. 브라질 포르투갈어 Flow: 서버에는 레이블 맵<SKILL_DIR>/flow-mcp/src/labels.ts가 필요합니다(이미 생성, 캐릭터, 미디어 선택기 및 다운로드를 다룸). 레이블을 편집한 후flow-mcp에서npm run build를 실행하고 Claude를 다시 시작하십시오. 오류 "waiting for getByRole('button', { name: '<영어>' })" = 거기에 매핑해야 하는 새 레이블입니다. 프로젝트가 열려 있고 페이지가 새로고침(F5)되어 있어야 합니다.- 누락된 것만 질문하십시오: 스타일(10개 중 하나), 전체 길이, 화면 비율(기본 9:16), 내레이션 또는 대화(기본 내레이션), 자막 스타일. 사용자가 이미 주제를 제공했다면 다시 묻지 마십시오.
01단계 — 주제
주제가 없으면 요청된 카테고리(코미디, 호기심, 공포, 모험, 아동, 동기부여, SF, 판타지)에서 5가지 아이디어를 제안하고, 선택한 스타일이 잘하는 것(references/estilos.md의 "Combina com" 참고)을 고려하십시오.
01-tema.md에 기록: 제목, 카테고리, 장르, 대상, 시놉시스(2-3문장), 세계관(언제/어디서, 세계 규칙, 분위기).
02단계 — 대본
전체 길이를 장면으로 나눕니다. 각 장면은 4, 6, 8 또는 10초입니다(비디오 모델 제한). 6-8초를 선호합니다. 한 장면 = 하나의 연속적인 샷, 하나의 주요 동작.
02-roteiro.md에 기록: 제목, 시놉시스, 캐릭터, 배경, 장면/길이/내용 표, 그리고 각 장면에 대해:
- 환경 · 등장 캐릭터 · 주요 동작
- 표정 · 신체 움직임 · 시각적 요소
- 내레이션 또는 대사(장면 초당 약 2.5단어 이하; 강조할 단어는
*별표*로 표시) - 장면의 최종 상태(캐릭터 위치, 사물, 조명) — 다음 장면의 입력
1번 장면은 갈고리(처음 2초 안에 무언가 발생). 마지막 장면은 결말을 제공합니다. 표를 보여주고 승인을 요청하십시오.
03단계 — 연출
references/estilos.md에서 스타일 블록을 읽으십시오. 03-direcao.md에 기록:
캐릭터 시트(시각적 메모리) — 각 캐릭터에 대해: 겉보기 나이, 체형과 비율, 얼굴, 머리카락, 옷과 액세서리(정확한 색상), 특징. 시트를 영어로, 재사용 가능한 한 단락으로 작성하십시오. 한 번 정의되면 변경되지 않습니다.
장면별 프롬프트, 영어로, 다음 순서:
동작 및 주어(전체 시트 붙여넣기, 절대 "the same man" 사용 금지) → 샷 및 카메라 움직임 → 장소 → 스타일 블록 → 조명 → 사운드.
- 카메라: 장면당 하나의 움직임만. 와이드 샷은 장소 설정, 미디엄은 동작, 클로즈업은 감정.
flow_techniques사용(static,lateral-track,crane-up,pull-back-reveal,crash-zoom등)을technique필드에 사용하십시오. - 움직임: 스타일의 "Movimento" 라인을 따르십시오(예: 클레이 = 12fps 스톱 모션).
- 연속성: 각 장면의 시작은 이전 장면의 최종 상태를 설명합니다.
- 내레이션 포함: 프롬프트를
Ambient sound and sound effects only, no dialogue, no speech, no subtitles, no on-screen text.로 끝내십시오. - 대화 포함: 따옴표 안에 누가 말하는지 적고, 길이에 맞게 충분히 짧게 작성하십시오.
캐릭터 및 키프레임 생성 (무료)
- 각 캐릭터에 대해
flow_character:describe= 캐릭터 시트 + 스타일 블록. - 장면당 하나의 키프레임(이미지):
flow_generate사용,type: "image",model: "Nano Banana 2",aspect_ratio,reference_images: ["asset:<이름>"], 2번 장면부터는reference_previous: true. 모든 장면을 한 번의 호출로 처리하십시오. 한 장면이 실패하면reference_previous가 이후 장면을 연쇄적으로 망가뜨립니다: 나머지 장면을reference_images(캐릭터 + 승인된 1번 장면 키프레임,asset:<제목>)로 다시 생성하고 체인을 사용하지 마십시오. Flow의 제목은 프로젝트 번호를 따릅니다(2번 장면이scene-06이 될 수 있음); 복사할 때cena-NN으로 이름을 바꾸십시오. flow_wait로finished될 때까지 기다리십시오.05-render/keyframes/cena-NN.png로 복사하고 사용자에게 보여주십시오. 이미지는 0 크레딧: 캐릭터, 배경, 스타일이 일관될 때까지 자유롭게 재생성하십시오. 그런 다음에만 비디오로 넘어가십시오.
04단계 — 자막 및 내레이션
-
음성:
flow_voices; 2-3개 제안하십시오(예: Charon 정보 제공, Aoede 가벼움, Sulafat 따뜻함, Puck 활기찬, Gacrux 성숙). -
flow_narrate장면당 한 번(텍스트 ≤ 400자, 별표 제외),style을 영어로 작성하고 브라질 포르투갈어와 분위기를 요청하십시오(예: "in Brazilian Portuguese, playful storyteller"). 각 오디오를04-legendas/narracao/cena-NN.m4a로 복사하십시오. 로컬 VoiceStudio (사용자가 가지고 있는 경우 선호):POST http://127.0.0.1:3900/v1/audio/speech{"model":"omnivoice","input":<텍스트>,"voice":<프로필의 voice_id>,"response_format":"wav","language":"pt"}사용 (프로필은GET /v1/audio/voices에서 확인; 선택한 프로필의voice_id사용). 할당량 없음, 문장당 약 5초. UTF-8 JSON을 Python으로 전송하고(Git Bash의 curl은 악센트를 깨뜨림), ffmpeg로cena-NN.m4a로 변환한 후POST /v1/audio/transcriptions로 발음을 확인하십시오.flow_narrate의 무료 Gemini는 하루 10회, 분당 3회로 제한됩니다. -
projeto.json(아래 형식)을 작성하고 실행:python "<SKILL_DIR>/scripts/montar.py" "videos/<slug>" --so-legendas각 오디오의 실제 길이에 맞춰 동기화된
legendas.srt+legendas.ass를 생성합니다. 내레이션이 장면보다 길다고 경고하면 텍스트를 줄이거나 장면을 늘리십시오. -
수동 편집: 사용자가
legendas.srt를 편집하고legenda에"manual": true를 설정하면 스크립트가 SRT를 덮어쓰지 않습니다.
자막 스타일: cinematografica (흰색, 미묘함), tiktok (큰 단어, 대문자, 노란색 강조), anime (굵게, 분홍색 강조), cartoon (재미있는 글꼴, 주황색 강조), minimalista (작게). 각 시각적 스타일에는 references/estilos.md에 제안 사항이 있습니다. 9:16에서는 tiktok을 사용하십시오(사용자가 세로 비디오에서 크기와 스타일을 승인했습니다): minimalista와 cinematografica는 휴대폰에 너무 작습니다. 미묘하게 하려면 tamanho ≥ 6(짧은 쪽의 %)을 전달하십시오.
05단계 — 렌더링
장면 생성
- 비용을 먼저 알리십시오: Omni 1.1 Flash ≈ 장면당 7크레딧(4초)~12크레딧(8초); Veo 3.1 Fast 20(고정 8초); Quality 100. 기본값: Omni 1.1 Flash, 720p. "ok"를 기다리십시오.
flow_generate를 모든 장면을 한 번의 호출로 사용:type: "video",prompt,duration,aspect_ratio,first_frame= 승인된 장면 키프레임,technique. (Flow는 초기 프레임 또는 참조 중 하나만 허용하며 둘 다 허용하지 않습니다 — 키프레임이 이미 캐릭터를 전달합니다.) 두 장면 사이의 연속 샷을 위해first_frame대신chain_previous: true를 사용하십시오.first_frame: "asset:<Flow의 키프레임 제목>"을 사용하고(키프레임이 이미 프로젝트에 있음), 파일 경로는 사용하지 마십시오. 업로드가 가장 취약한 경로입니다. 실제 비용: 장면당 6초 10크레딧, 8초 12크레딧 (Omni 1.1 Flash, 720p).flow_wait로 완료될 때까지 기다리십시오. 작업이 "The finished tile is no longer in the grid" 오류로 실패하면 클립이 생성 및 청구된 것입니다: 다시 생성하지 마십시오.flow_assets(kind video) 및flow_download를 Flow가 제공한 제목의 시작 부분과 함께 장면 순서대로 사용하십시오. 각 클립을05-render/cenas/cena-NN.v1.mp4로 복사하십시오. 첫 번째 장면이 생성되기 전에 실패하면 나머지 큐를 취소하여 오류가 반복되지 않도록 하십시오.
검토 및 재생성
클립을 보여주십시오. 장면 N을 다시 만들려면: flow_generate를 해당 장면만으로 새 project(예: <slug>-c03-v2, 다른 파일 이름과 충돌하지 않도록)에서 호출하고, cena-NN.v2.mp4로 복사한 후 projeto.json의 clip을 선택한 버전으로 지정하십시오. 이전 버전을 삭제하거나 다른 장면의 파일을 건드리지 마십시오. 프롬프트가 변경되었습니까? 03-direcao.md를 업데이트하십시오.
합성
python "<SKILL_DIR>/scripts/montar.py" "videos/<slug>"
각 클립을 대상 해상도/fps로 정규화하고, 순서대로 연결하며, 각 내레이션을 해당 장면의 시작 부분에 배치하고, 클립 사운드 + 음악을 믹싱하고, 자막을 인코딩하거나(또는 SRT만 남기고) 05-render/final.mp4로 저장하며, 시작 및 종료 페이드 효과를 추가합니다. 장면을 재생성했습니까? 다시 실행하기만 하면 됩니다. 변경되지 않은 클립은 캐시에 남아 있습니다.
projeto.json
{
"titulo": "타임머신",
"estilo": "massinha",
"render": { "proporcao": "9:16", "resolucao": "1080p", "fps": 30, "codec": "h264", "legendas": "embutidas" },
"legenda": { "estilo": "tiktok", "posicao": "baixo" },
"audio": { "musica": "musica.mp3", "volume_musica": 0.2, "volume_clipes": 0.3, "velocidade_narracao": 1.0 },
"cenas": [
{ "id": 1, "duracao": 6,
"clip": "05-render/cenas/cena-01.v1.mp4",
"narracao": "한 남자가 신비한 *기계*를 발견합니다.",
"audio": "04-legendas/narracao/cena-01.m4a" }
]
}
proporcao: 9:16, 16:9, 1:1 ·resolucao: 720p, 1080p, 4k ·fps: 24, 30, 60codec: h264, h265 ·legendas: embutidas, srt, nenhumalegenda:estilo,posicao(baixo/meio/topo) 및 선택 사항fonte,tamanho(짧은 쪽의 %),cor,destaque(hex RRGGBB),manualaudio: 모두 선택 사항. 음악: 사용자에게 파일을 요청하십시오(스킬이 음악을 생성하지 않음).- 경로는 프로젝트 폴더를 기준으로 합니다.
알려진 제한 사항
- 입술 동기화는 비디오 프롬프트에서 대사가 따옴표 안에 있을 때만 가능합니다(모델이 클립에서 음성을 생성함). 별도의 내레이션으로는 립싱크가 없습니다.
- 자막 동기화는 장면별로 이루어지며(오디오의 실제 길이) 단어가 장면 내에 비례적으로 분산됩니다.
- 전환은 하드 컷입니다. 두 장면 사이에 애니메이션 전환을 원하면
first_frame+last_frame및transition카테고리의technique으로 클립을 생성하십시오. - 클립은 Flow에서 720p로 나옵니다. 1080p/4K는 업스케일입니다(
download_quality: "upscaled"도움).