Anúncios IA Lab
대본 → 캐릭터 → 장면 → 이미지 → 장면 01 영상 → 나머지 대기열 → 편집. 어떤 단계도 사용자가 이전 단계를 승인하지 않으면 시작되지 않습니다. 각 단계는 KIE 크레딧을 소모하며, 사용자가 거부한 결과물은 영상으로 제작되지 않습니다.
세 가지 스타일
| 스타일 | 언제 | 참고 자료 (4단계 전에 읽으세요) |
|---|---|---|
pixar (기본) | "크리에이티브 애니메이션", "픽사 스타일", "애니메이션" | referencias/pixar-referencia.md |
novelinha | "소설처럼", "소설 모델", "사실적", "실제 아바타" | referencias/novelinha-referencia.md |
office | "오피스 스타일", "가짜 다큐멘터리", "모큐멘터리", "올드 비주얼", "카메라 인터뷰" | referencias/office-referencia.md |
7단계 파이프라인은 세 스타일 모두 동일합니다. 비주얼( referencias/estilos/<estilo>.json 의 필드, kie.py estilo 으로 적용)과 소설/오피스 스타일의 장면 문법(4단계)만 다릅니다. 스타일이 모호하다면 2단계를 멈추지 말고 3단계와 함께 질문하세요. 한 스타일의 캐릭터는 다른 스타일에 사용할 수 없습니다. 픽사 캐릭터는 소설에 등장하지 않습니다.
프롬프트 템플릿: referencias/prompts.md. 2, 5, 6단계 전에 읽으세요.
각 요소 위치
- 키:
KIE_API_KEY환경 변수 또는 이 스킬 폴더의.env파일(KIE_API_KEY=...). 스크립트가 자동으로 읽습니다. 채팅에서 키를 절대 노출하지 마세요. 키가 없으면 사용자에게 kie.ai에서 키를 생성하고.env에 저장하도록 요청하세요. - 스크립트:
python3 ~/.claude/skills/anuncios-ia-lab/scripts/kie.py. 표준 라이브러리와 ffmpeg만 사용합니다. 3.9 이상의 모든 python3에서 작동합니다. - 프로젝트:
~/Criativos animados/<YYYY-MM-DD 짧은 이름>/:roteiro.md 사용자가 보낸 대본 projeto.json 캐릭터, 장면, 프롬프트 및 생성된 모든 항목 (아래 형식) cenas.md 사용자가 승인한 장면 텍스트 personagens/ <id>_v1.png, <id>_v2.png… (수정된 버전은 antigas/로 이동) imagens/cenaNN.png 각 장면의 첫 번째 프레임 videos/cenaNN.mp4 애니메이션 장면 tarefas.jsonl 각 생성 로그: KIE 태스크, 크레딧, 링크 edicao/ 합성, 자막 및 최종 영상 (edicao/ 편집 스크립트) - KIE 모델 (모두
POST /api/v1/jobs/createTask, 이후recordInfo):grok-imagine-image-2-0/text-to-image: 참조 없는 캐릭터.grok-imagine-image-2-0/image-edit: 최대 5개의 참조 이미지(캐릭터 및 환경)가 있는 장면.- 영상, 기본값:
grok-imagine-video-1-5-preview(별칭grok15). 첫 번째 프레임(first_frame_url)을 기반으로 1~15초, 9:16 비율, 720p, 오디오 및 음성 포함. 초당 4.5크레딧. - 대안:
google/gemini-omni-flash-1-2(별칭omni), 720p에서 초당 9크레딧. 사용자가 요청하거나 프로젝트가 이미 이 모델로 시작된 경우에만 사용(projeto.json에"modelo_video": "omni"), 광고 중간에 음성이 변경되지 않도록 합니다.
스크립트 명령
K="$HOME/.claude/skills/anuncios-ia-lab/scripts/kie.py" # 항상 python3 "$K" 로 호출 (zsh는 $K 분리 안 함)
python3 "$K" saldo
python3 "$K" estilo --projeto "$P" --nome pixar|novelinha|office # 스타일로 프로젝트 생성
python3 "$K" lote --projeto "$P" --tipo personagens # 승인 없는 각 캐릭터 변형
python3 "$K" lote --projeto "$P" --tipo imagens # 이미지 없는 모든 장면의 첫 번째 프레임
python3 "$K" lote --projeto "$P" --tipo imagens --cenas 03,07 --refazer
python3 "$K" lote --projeto "$P" --tipo videos --cenas 01 # 6단계
python3 "$K" lote --projeto "$P" --tipo videos --cenas 02- --paralelo 3 # 7단계, 대기열
python3 "$K" folha --projeto "$P" --tipo personagens # (또는 --tipo imagens): 접촉 시트
python3 "$K" juntar --projeto "$P" --aparar # 간단한 final.mp4, 편집 없음
python3 "$K" status <taskId>
동일 배치의 다른 장면 이미지를 참조로 사용하는 장면은 해당 이미지가 준비될 때까지 기다렸다가 다음 배치로 넘어갑니다.
--simular 은 크레딧 소모 없이 전송될 내용을 보여줍니다. 각 새 배치 전에 한 번씩 실행하여 프롬프트와 참조를 확인하세요. lote 는 전후 잔액을 표시하고 지출 금액을 알려줍니다. 이 숫자를 사용자에게 알리세요. 작업이 실패하면 동일한 명령을 다시 실행하면 실패한 작업만 다시 수행됩니다. 영상 배치는 시간이 오래 걸립니다. 백그라운드에서 실행하고(run_in_background) 확인을 기다리며, 계속 확인하지 마세요.
1단계: 대본 받기
- 올바른 스타일로 프로젝트 생성:
python3 "$K" estilo --projeto "$P" --nome pixar|novelinha|office. 명령은referencias/modelo-projeto.json을 기반으로 스타일 필드(estilo,estilo_personagem,estilo_video및regras_video)가 포함된projeto.json을 생성합니다. 받은 그대로의 대본을roteiro.md에 저장하세요. - 대본을 읽고 각 줄을 말하는 사람을 표시하세요. 대본에 명시되지 않은 경우 추론하세요. 대화는 두 캐릭터, 독백은 전문가가 카메라를 보며 말하는 것입니다. 대사는 다시 쓰지 마세요. 대본 텍스트가 그대로 영상에 사용됩니다.
- 모호한 부분(누가 말하는지, 전문가인지 여부)이 있으면 2단계를 멈추지 말고 3단계와 함께 질문하세요.
2단계: 캐릭터 생성
- 각 캐릭터에 대해
projeto.json에 포르투갈어 설명(descricao),visual(머리카락, 얼굴, 옷, 색상에 대한 영어 한 줄, 모든 장면에서 동일), 영어prompt및voz(모델은referencias/prompts.md참조)를 작성하세요. 전체 광고에 대해 정확한 아이템과 색상으로 하나의 의상만 정의하세요. - 캐릭터당
variacoes: 2생성:lote --tipo personagens. 실제 사람인 캐릭터: 사진을refs에 넣습니다. - 전송하기 전에 Read로 각 이미지를 확인하세요. 명백한 결함(텍스트, 변형된 손, 두 명 이상의 사람, 설명과 다른 옷)이 있는 이미지는 사용자에게 보내기 전에 한 번 수정하고, 사용자에게 수정했다고 알립니다.
소설 스타일에서는 캐릭터가 사실적인 사람입니다. 실제 얼굴, 피부, 옷, 그림체 없음(novelinha.json의 estilo_personagem 및 prompts.md의 사실적인 캐릭터 모델). 실제 전문가가 등장하는 경우, 광고가 그 사람의 것이고 이미지 사용을 허가한 경우에만 사진을 refs 에 넣습니다. 의상은 이야기의 각 "일" 내에서 고정됩니다. 대본에 시간 또는 장소 이동이 있는 경우("30일 후", "결혼식에서"), 동일한 캐릭터의 새 옷을 입은 두 번째 이미지를 생성하고(참조 = 승인된 이미지), 승인을 위해 보내고 해당 부분의 장면에서 사용하세요. 체중 감량의 경우 "후"는 신체도 변경합니다(prompts.md 레시피).
오피스 스타일에서는 캐릭터도 사실적이지만, 캐스팅 사진은 이미 올드 비주얼로 제공됩니다. 2000년대 사무실(회색 파티션, 브라운관 모니터, 형광등) 안에 서 있는 전신 인물로, office.json의 estilo_personagem을 사용합니다. 사용자가 사람과 "분위기"를 함께 승인합니다. 시대에 맞는 사무실 복장(단추 블라우스, 가디건, 슬랙스, 텍스트 없는 명찰). 체형 대비(체중 감량자 vs 비감량자)는 prompts.md의 레시피를 따릅니다.
3단계: 캐릭터 승인
SendUserFile로 모든 이미지를 한 번에 보내고(모든 이미지를 한 번에, "Ana v1, Ana v2, Rafa v1…" 캡션 포함) 각 캐릭터의 정보를 2줄로 작성하세요. 어떤 버전을 유지할지 또는 무엇을 변경할지 질문하세요. 사용자가 승인하면 imagem (선택한 파일) 및 aprovado: true 를 캐릭터에 기록합니다. 조정 사항은 새 프롬프트와 해당 캐릭터만 다시 생성(--refazer)합니다(--cenas <id>도 캐릭터 필터링).
4단계: 장면 분할
장면은 최대 8초 예상되는 대사 구간으로, 하나의 이미지와 하나의 영상이 됩니다. Grok 1.5의 경우 초당 3.9단어 + 0.5초 + 화자 전환당 0.3초로 예상하고, 올림하며 최소 3초입니다. Omni의 경우 초당 3단어 + 0.5초 + 전환당 0.7초입니다. 6단계에서 장면 01이 나온 후 실제 대사로 이 계산을 다시 조정하세요.
Grok 1.5에서 확인된 사항:
- 대사가 이어져 화자 전환 시 멈춤 없이
초당 3.84단어. - 클립에 시간이 남으면 Grok이 대사를 만들어냅니다("É, continua mesmo", "Calma, eu vou te ajudar"). 따라서 지속 시간을 빡빡하게 맞추고, 대사 종료 후 무음 절단을 요청하지 않으며,
regras_video는 마지막 따옴표 대사 이후 아무도 말하지 않는다고 명시합니다. 확인 시 대본에 없는 모든 전사된 문장은 장면을 다시 만들어야 하는 이유입니다. 클립 끝에 만들어진 대사는 편집 시 제거되며(대본 단어만 유지), 그러나 초는 이미 지불되었습니다. - 화면 속 화면(휴대폰 영상, TV)의 캐릭터는 프롬프트에
the video on the phone is muted라고 명시하지 않으면 함께 말합니다.na_tela필드를 사용하세요. - 얼굴 없는 클로즈업과 흔들리는 카메라는 사람을 만들어냅니다. 신체 클로즈업에서는
Static locked camera, no camera movement, the head never enters the frame, nobody else appears라고 작성하세요. - 연속된 두 대사 사이에 반복된 단어는 사라집니다. "Posso começar hoje?" / "Hoje."의 경우 Grok이 둘 중 하나를 자릅니다. 이전 대사를 반영하는 대사는 별도 클립에 넣거나 장면을 둘로 나누세요.
세 가지 스타일 모든 장면에 적용되는 규칙:
- 항상 상호 작용. 캐릭터는 서로를 바라보고 상대방의 말에 반응합니다. 카메라를 바라보는 사람은 없습니다. 단, 마지막 콜투액션("clica em saiba mais")에서 전문가와, 오피스 스타일에서 인터뷰 및 응시는 예외입니다. 이미지와 영상 모두에 적용됩니다. 프롬프트에 각 캐릭터가 어디를 보는지 명시하세요(
Rafa looks at Ana). - 말하는 사람이 말하는 모습이 보여야 합니다. 각 샷에서 말하는 사람이 프레임 안에 충분히 크게 보여 입이 보여야 하며, 정면 또는 듣는 사람을 향해 3/4 각도로, 입이 가려지지 않아야 합니다 (손으로 입을 막거나, 포옹에 얼굴이 가려지거나, 뒤통수만 보이면 안 됨). 광고의 첫 대사는 후크입니다. 말하는 사람의 미디엄 샷 또는 더 가까운 샷이어야 하며, 멀리 있는 작은 사람이 아니어야 하고, 또렷하게 말해야 합니다.
- 이 규칙이 생긴 오류: 후크가 "frozen in shock with one hand over her mouth"로, 와이드 샷에서 요청되었습니다. 캐릭터가 문 앞에서 손으로 입을 막고 작게 말했고, 시청자는 누가 말하는지 이해하지 못했습니다.
- 누가 누군지 항상 명시적. 전문가의 대사가 다른 캐릭터의 입에서 나오는 경우가 있었습니다. 각 캐릭터는 프로필에
visual한 줄(머리카락, 얼굴, 옷, 색상, 영어)이 있습니다. 각 장면의 이미지는 해당 프로필로 식별 가능한 장면의personagens목록에 있는 캐릭터를 정확히 보여줘야 합니다. 영상 프롬프트는 각 대사에서 말하는 사람을 비주얼과 함께 명시합니다(Carla (short curly black hair, white lab coat), warm: "..."). 스크립트는 자동으로 "Who is who" 블록(프레임 내 각자의 이름, 비주얼, 음성; 오프스크린에서 말하는 사람; 클립에서 말하지 않는 사람; 각 대사는 지명된 사람의 입에서만 나옴)을 추가합니다. - 장면이 사용하는 모든 것은 이미 이미지에 있습니다. 영상은 첫 번째 프레임에 있는 것만 애니메이션합니다. 사람이 런닝머신을 끄려면 런닝머신 패널이 이미지에 있어야 합니다. 냉장고를 열려면 냉장고가 있어야 합니다. 파티션 너머를 엿보고 그 뒤에 숨으려면 파티션이 그녀 앞에 전체가, 올바른 높이로 있어야 합니다. 누락되면 Grok이 즉흥적으로 만듭니다. 사람이 허공을 붙잡고 물체가 클립 중간에 나타납니다.
- 이 규칙이 생긴 오류: 오피스 스케치에서 두 동료가 "파티션 너머를 엿보았지만" 이미지에는 그들 앞에 파티션이 없었습니다. 영상에서 두 사람은 보이지 않는 파티션을 붙잡았고, 그들이 숨을 때만 나타났습니다.
- 적용 방법: 장면을 작성할 때 클립의 첫 번째부터 마지막 초까지 전체 동작을 읽고, 누군가가 만지고, 잡고, 열고, 사용하고, 기대고, 뒤에 숨거나, 위에 놓는 모든 것을 나열하세요. 목록은
cenas.md의Elementos:줄과projeto.json의elementos필드(영어)에 들어갑니다. - 스크립트는 목록을 이미지 프롬프트("já está inteiro no primeiro quadro, no lugar e no tamanho certos")와 영상 프롬프트("só mexe no que está visível; nada aparece nem some; ninguém finge segurar algo invisível")에 씁니다. 세 가지 스타일의
regras_video에도 이 제한이 포함됩니다. - 이미지 확인 시 각 요소는 목록의 항목입니다. 누락, 가장자리 잘림, 잘못된 위치인 경우 애니메이션 전에 다시 만드세요.
- 장면 일관성. 각 장소는 고정된 배경을 가지며, 카메라가 한 캐릭터에서 다른 캐릭터로 전환될 때 변경되지 않습니다. 샷과 리버스 샷에서 각 배경은 같은 방의 반대편입니다. 창문은 같은 쪽에, 캐비닛은 같은 위치에, 같은 조명과 시간대. 누군가 집은 것은 다음 장면에서 계속 손에 있고, 접시는 위치가 바뀌지 않으며, 머그잔은 사라지지 않습니다.
- 적용 방법: 각 장소를
ambientes에 한 번 설명하고(영어로 배치: 왼쪽, 오른쪽, 뒤에 있는 것) 각 장면에ambiente를 표시하세요. 스크립트는 해당 장소의 모든 장면에서 동일한 설명을 반복합니다. 해당 장소를 여는 장면이 먼저 생성되고 다른 장면의refs에 들어갑니다. - 서 있거나 앉아 있는 사람은 장면이 변경을 보여줄 때까지 그 상태를 유지합니다.
- 확인 시 각 이미지를 같은 장소의 이전 이미지와 비교하세요. 벽, 가구, 창문 쪽, 조명, 물체, 자세.
- 적용 방법: 각 장소를
픽사 스타일 역동성 규칙(약 2초마다 샷 변경 참조):
- 이전 장면의 프레이밍을 반복하지 마세요. 두 사람이 함께, 어깨 너머, 반응 클로즈업, 전문가 단독으로 카메라를 보며 말하기, 일러스트레이션을 번갈아 사용하세요.
- 6
8초 장면은 내부에 23개의 샷을 포함합니다(예: 두 사람이 함께, 그 다음 듣는 사람의 반응 클로즈업으로 하드 컷). 3~4초 장면은 하나의 샷만 포함합니다. - 말하는 내용이 이미지가 됩니다. 신체 부위, 숫자, 비교, "TikTok 영상", "녹화된 강의": 문자 그대로 과장되게 표현하세요(대사가 달린 신진대사, 숯불처럼 타는 배, 몸에서 빠져나가는 영혼, 손에 든 휴대폰 화면에 장면). 이러한 장면은 3초 동안 지속될 수 있습니다.
- 듣는 사람의 과장된 픽사 스타일 반응: 충격, 분노, 의심, 웃음.
- 주장 전환점에서 환경 변경(문제에서 메커니즘으로, 메커니즘에서 제안으로).
- 마지막 콜투액션: 전문가 단독, 카메라를 바라보며 아래를 가리킴. 두 사람이 함께 반응하며 마무리.
소설 스타일은 다른 문법을 가집니다 (자세한 내용은 novelinha-referencia.md 참조):
- 한 사람
…