katha-studio은(는) 무엇을 하나요?
사용자와 함께 완성된 애니메이션 영화를 제작합니다. 하나의 영화는 하나의 폴더와 하나의 film.json 파일로 구성됩니다.
도구는 python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" 입니다 (이하 KATHA). pip 패키지가 필요하지 않습니다.
유료 단계 (시트, 이미지, 대화, 이동)에서는 가격을 출력하고 중단됩니다. --yes 플래그가 있어야만 비용이 청구됩니다.
--yes는 사용자가 채팅에서 해당 가격에 동의한 후에만 실행하세요. 음성 단계는 사용자의 ElevenLabs 할당량을 사용합니다.
필요할 때 다음 파일을 참조하세요:
references/film-format.md: film.json의 모든 필드에 대한 설명.references/story-craft.md: 시청자를 사로잡는 카타 대본 작성 방법과 샷 규칙.references/troubleshooting.md: 알려진 오류와 해결 방법.
0. 첫 실행: 안내 설정
사용자가 처음이거나, 이후 단계에서 도구나 키가 없다는 오류가 발생할 때 이 단계를 수행합니다.
KATHA doctor를 실행합니다. 각 항목에 대해 OK 또는 MISS와 함께 해결 방법을 출력합니다.- 각 MISS 항목에 대해, 사용자에게 해당 시스템에 맞는 정확한 수정 명령어를 한 번에 하나씩 알려줍니다. 사용자가 완료했다고 말할 때까지 기다립니다.
- 키: 사용자에게 fal 키 (https://fal.ai/dashboard/keys) 와 ElevenLabs 키 (https://elevenlabs.io/app/settings/api-keys) 를 만들고, fal에 크레딧을 추가하라고 알려줍니다 (첫 단편 영화의 경우 US$10이면 충분합니다).
- 사용자에게 자신의 터미널에서
python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" setup을 실행하라고 알려줍니다. 채팅에 키를 붙여넣도록 요청하지 말고, 직접 키를 입력하지 마십시오. KATHA doctor를 다시 실행합니다. READY 상태일 때만 계속 진행합니다.
참고: ElevenLabs 무료 요금제는 상업적 사용을 허용하지 않습니다. 수익을 창출하는 채널은 Starter 이상 요금제가 필요합니다.
1. 스토리 (게이트 1: 사용자가 대본 승인)
- 한 번에 하나씩 질문합니다: 스토리, 언어, 길이 (첫 영화는 1~3분부터 시작), 채널 이름.
KATHA new <폴더> --title "<제목>" --language <코드>를 실행합니다.film.json을 작성합니다: 스타일, 각 캐릭터에 대한 완전한look이 있는 캐릭터들, 목소리 (내레이터 및 각 말하는 캐릭터용 하나씩), 그리고 장면들.references/story-craft.md를 따릅니다.KATHA validate <폴더>를 실행하고 모든 FAIL을 수정합니다.- 사용자에게 표 형태의 대본 (ID, 화자, 종류, 대사, 간단한 그림 설명)과
KATHA cost <폴더>결과를 보여줍니다. 사용자가 승인할 때까지 변경합니다.
2. 목소리
KATHA voices --language <코드>를 실행합니다 (범위를 좁히려면--gender male,--accent standard또는--search "old"를 추가). 각 역할에 대해 미리보기 링크와 함께 3가지 선택지를 사용자에게 제공합니다.- 사용자가 선택하면
voice_id를film.json의voices에 입력합니다. 라이브러리 음성은 계정에 추가하지 않고도 작동합니다. - 음성 단계에서 "voice not found" 오류가 발생하는 경우에만
KATHA voices --add <voice_id> --owner <소유자> --name "<역할>"을 실행합니다. 이렇게 하면 계정의 음성 슬롯 중 하나가 사용됩니다. KATHA voice <폴더> <2 또는 3개의 ID>를 실행하고, 전체 영화에 음성을 입히기 전에 사용자에게audio/raw<ID>.mp3를 들어보도록 요청합니다.
3. 캐릭터 (게이트 2: 사용자가 각 시트 승인)
KATHA sheets <폴더>를 실행하고 가격을 사용자에게 알린 후, 사용자가 동의하면--yes와 함께 실행합니다.- 읽기 도구를 사용하여 모든
img/char_<ID>.png를 직접 확인합니다. 나이, 얼굴, 의상, 색상 및 인원 수를 확인합니다. - 시트를 사용자에게 보여줍니다. 시트가 잘못된 경우 해당 캐릭터의
look을 변경하고KATHA sheets <폴더> <ID> --yes를 실행합니다.
시트는 영화의 정체성입니다. 사용자가 시트를 승인하기 전에는 절대로 장면 그림을 만들지 마십시오.
4. 그림, 음성, 모션
KATHA images <폴더>(가격 확인), 그 다음--yes와 함께 실행합니다. 누락된 그림만 생성합니다.img/contact.jpg를 살펴본 다음, 잘못된 것처럼 보이는 각 그림을 엽니다. 확인할 사항: 올바른 캐릭터, 추가 인물 없음, 텍스트 없음, 잘못된 왕관이나 의상 없음, 그리고 모든 대화 장면에는 입을 다문 명확한 정면 얼굴이 있어야 합니다.- 잘못된 그림을 다시 만듭니다:
image프롬프트를 개선한 후KATHA images <폴더> <ID> --yes --redo를 실행합니다. KATHA voice <폴더>. 각 대사를 캐시하므로 두 번째 실행은 무료입니다. 텍스트 변경 후 한 대사를 다시 만들려면KATHA voice <폴더> <ID>를 실행합니다.KATHA talk <폴더>(가격 확인), 그 다음--yes와 함께 실행합니다. 해당 장면의 그림과 음성이 최종 확정된 후에만 실행하세요: 새 그림이나 새 음성에는 새 클립이 필요합니다.- 모든
clips/s<ID>_check.jpg를 직접 확인합니다. 글자, 가짜 자막 또는 변경된 얼굴이 표시된 클립을 다시 만듭니다:KATHA talk <폴더> <ID> --yes --redo. - 영화에
move장면이 있는 경우:KATHA move <폴더>(가격 확인), 그 다음--yes와 함께 실행합니다.
5. 빌드 및 확인 (게이트 3: 사용자가 영화 시청)
KATHA build <폴더>. 출력:out/<슬러그>.mp4및out/thumbnail.jpg.KATHA check <폴더>가 PASS를 출력해야 합니다.KATHA frames <폴더>를 실행한 다음,out/frames.jpg와 썸네일을 직접 확인합니다.out/youtube.md를 작성합니다: 제목 옵션 3개 (70자 미만, 스토리 이름과 감정적 후크), 설명 (요약 2줄, 교훈, 스토리의 원본 텍스트, 장면 길이에 따른 타임스탬프가 포함된 챕터), 태그 10개, YouTube Studio의 변경된 콘텐츠 질문에 대한 "Made with AI tools" 문구.- 사용자에게 사운드와 함께 전체 영화를 시청하도록 요청합니다. 사용자가 요청하는 각 수정 사항을 해당 단계에서 처리한 후 다시 빌드합니다.
실제 오류에서 비롯된 규칙
- 모든 대화 장면은 정면 클로즈업, 머리와 어깨, 입을 다문 상태여야 합니다. 측면이나 숙인 머리는 립싱크 품질이 좋지 않습니다.
- 대화 프롬프트는 기본값 "."으로 남겨둡니다. 대사나 "자막 없음"과 같은 단어가 포함된 프롬프트는 테스트에서 Kling이 가짜 자막 텍스트를 그리게 했습니다. Kling에는 네거티브 프롬프트가 없습니다.
- 성인 신의 경우 "약 30세 성인 남성 (어린이가 아님)"이라고 작성합니다. 이렇게 하지 않으면 모델이 종종 크리슈나 등을 어린이로 그립니다.
- 장면에서 캐릭터가 특정 의상을 입지 말아야 할 위험이 있을 때는 무엇을 입지 말아야 하는지 명시합니다 (가난한 브라민의 경우 "왕관, 장신구 금지"). 모델이 프레임 내 다른 캐릭터의 의상을 복사하기 때문입니다.
- 각 대사는 약 250자 미만으로 유지합니다. 긴 대사는 2개의 장면과 2개의 그림으로 나눕니다.
- 다른 채널의 대본, 캐릭터 또는 썸네일을 복사하지 마십시오. 옛날 이야기는 자유롭게 말할 수 있지만, 다른 채널의 구체적인 표현은 그렇지 않습니다.
- YouTube는 "진정하지 않은 콘텐츠" (인간의 작업 없이 대량 제작된 영화)에 대해 수익 창출을 중단할 수 있습니다. 사용자에게 스토리와 구성을 다양화하고, 자신의 목소리로 직접 인트로나 교훈을 추가하라고 알려줍니다.