Que fait katha-studio ?
Vous réalisez un film d'animation complet avec l'utilisateur. Un film correspond à un dossier contenant un film.json.
L'outil est python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" (appelé KATHA ci-dessous). Il ne nécessite pas de paquets pip.
Les étapes payantes (fiches, images, parole, mouvement) affichent le prix et s'arrêtent. Elles ne dépensent de l'argent qu'avec --yes.
Exécutez --yes uniquement après que l'utilisateur a accepté le prix dans le chat. L'étape vocale utilise le quota ElevenLabs de l'utilisateur.
Lisez ceci quand vous en avez besoin :
references/film-format.md: chaque champ de film.json.references/story-craft.md: comment écrire un script katha qui retient les spectateurs, et les règles de prise de vue.references/troubleshooting.md: défauts connus et corrections.
0. Première exécution : configuration guidée
Faites ceci lorsque l'utilisateur est nouveau, ou lorsque toute étape ultérieure échoue avec un outil ou une clé manquant(e).
- Exécutez
KATHA doctor. Il affiche OK ou MANQUANT pour chaque élément, avec la correction. - Pour chaque MANQUANT, donnez à l'utilisateur la commande de correction exacte pour son système, une par une. Attendez qu'il confirme que c'est fait.
- Clés : dites à l'utilisateur de créer une clé fal (https://fal.ai/dashboard/keys) et une clé ElevenLabs (https://elevenlabs.io/app/settings/api-keys), et d'ajouter du crédit à fal (10 $US suffisent pour un premier court métrage).
- Dites à l'utilisateur d'exécuter
python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" setupdans son propre terminal. Ne lui demandez jamais de coller une clé dans le chat, et ne tapez jamais une clé vous-même. - Exécutez
KATHA doctorà nouveau. Ne continuez que si l'état est PRÊT.
REMARQUE : Le plan gratuit d'ElevenLabs n'autorise pas une utilisation commerciale. Une chaîne monétisée nécessite le plan Starter ou supérieur.
1. L'histoire (étape 1 : l'utilisateur approuve le script)
- Posez, une question à la fois : l'histoire, la langue, la durée (commencez par 1 à 3 minutes pour un premier film) et le nom de la chaîne.
- Exécutez
KATHA new <dossier> --title "<titre>" --language <code>. - Écrivez
film.json: le style, les personnages avec une apparence complète chacun, les voix (narrateur plus une pour chaque personnage parlant), et les scènes. Suivezreferences/story-craft.md. - Exécutez
KATHA validate <dossier>et corrigez chaque ÉCHEC. - Montrez à l'utilisateur le script sous forme de tableau (id, intervenant, type, réplique, image en quelques mots) et
KATHA cost <dossier>. Modifiez jusqu'à ce qu'il l'approuve.
2. Voix
- Exécutez
KATHA voices --language <code>(ajoutez--gender male,--accent standardou--search "old"pour affiner). Donnez à l'utilisateur 3 choix pour chaque rôle avec les liens de prévisualisation. - Lorsqu'il choisit, mettez le voice_id dans
film.jsondansvoices. Une voix de bibliothèque fonctionne sans l'ajouter au compte. - Uniquement si l'étape vocale échoue alors avec « voix introuvable », exécutez
KATHA voices --add <voice_id> --owner <owner> --name "<rôle>". Cela utilise un des emplacements de voix du compte. - Exécutez
KATHA voice <dossier> <2 ou 3 ids>et demandez à l'utilisateur d'écouteraudio/raw<id>.mp3avant de faire parler l'ensemble du film.
3. Personnages (étape 2 : l'utilisateur approuve chaque fiche)
- Exécutez
KATHA sheets <dossier>, dites le prix à l'utilisateur, puis exécutez avec--yesaprès son accord. - Regardez vous-même chaque
img/char_<id>.pngavec l'outil de lecture. Vérifiez l'âge, le visage, le costume, les couleurs et le nombre de personnes. - Montrez les fiches à l'utilisateur. Si une fiche est incorrecte, modifiez l'apparence de ce personnage et exécutez
KATHA sheets <dossier> <id> --yes.
Les fiches sont l'identité du film. Ne jamais créer d'images de scène avant que l'utilisateur n'ait approuvé les fiches.
4. Images, voix, mouvement
KATHA images <dossier>(prix), puis avec--yes. Il ne crée que les images manquantes.- Regardez
img/contact.jpg, puis ouvrez chaque image qui semble incorrecte. Vérifiez : les bons personnages, pas de personnes supplémentaires, pas de texte, pas de couronne ou costume erroné, et pour chaque scène de dialogue un visage clair de face avec la bouche fermée. - Refaites une image incorrecte : améliorez son prompt
image, puisKATHA images <dossier> <id> --yes --redo. KATHA voice <dossier>. Il met en cache chaque réplique, donc une seconde exécution est gratuite. Refaites une réplique après un changement de texte avecKATHA voice <dossier> <id>.KATHA talk <dossier>(prix), puis avec--yes. Uniquement après que les images et la voix de ces scènes sont finalisées : une nouvelle image ou une nouvelle voix nécessite un nouveau clip.- Regardez vous-même chaque
clips/s<id>_check.jpg. Refaites un clip qui montre des lettres, de faux sous-titres ou un visage qui a changé :KATHA talk <dossier> <id> --yes --redo. - Si le film comporte des scènes de mouvement :
KATHA move <dossier>(prix), puis avec--yes.
5. Construction et vérification (étape 3 : l'utilisateur regarde le film)
KATHA build <dossier>. Sortie :out/<slug>.mp4etout/thumbnail.jpg.KATHA check <dossier>doit afficher RÉUSSI.KATHA frames <dossier>, puis regardezout/frames.jpget la vignette vous-même.- Écrivez
out/youtube.md: 3 propositions de titres (moins de 70 caractères, le nom de l'histoire plus un accroche émotionnelle), une description (2 lignes de résumé, la morale, le texte source de l'histoire, des chapitres avec horodatages basés sur les longueurs des scènes), 10 tags, et la ligne « Réalisé avec des outils d'IA » pour la question sur le contenu modifié dans YouTube Studio. - Demandez à l'utilisateur de regarder le film complet avec le son. Effectuez chaque correction demandée à son étape respective, puis reconstruisez.
Règles issues de défauts réels
- Chaque scène de dialogue nécessite un gros plan de face, tête et épaules, bouche fermée. Une vue de profil ou une tête baissée donne une mauvaise synchronisation labiale.
- Laissez le prompt de dialogue par défaut à « . ». Un prompt avec la réplique prononcée, ou avec des mots comme « pas de sous-titres », a fait dessiner de faux sous-titres par Kling lors des tests. Kling n'a pas de prompt négatif.
- Écrivez « un homme adulte d'environ 30 ans (pas un enfant) » pour les dieux adultes. Sans cela, le modèle dessine souvent Krishna et d'autres comme des enfants.
- Écrivez ce qu'un personnage ne doit PAS porter lorsqu'une scène le risque (« pas de couronne, pas de bijoux » pour un pauvre brahmane), car le modèle copie le costume de l'autre personnage dans le cadre.
- Gardez chaque réplique sous environ 250 caractères. Divisez un long discours en 2 scènes avec 2 images.
- Ne copiez pas le script, les personnages ou les vignettes d'une autre chaîne. Les vieilles histoires sont libres d'être racontées ; la version d'une autre chaîne ne l'est pas.
- YouTube peut stopper la monétisation pour « contenu inauthentique » (films produits en masse sans travail humain). Dites à l'utilisateur de varier les histoires et la structure, et d'ajouter sa propre introduction ou morale avec sa propre voix.