# GUIDE.md — Ako vytvoriť 10-minútovú animovanú rozprávku pre deti pomocou AI video-modelov

> Kompletný návod: od témy → scenár → storyboard → dialógy, piesne a zvuky → výber modelu (Seedance, Veo, MiniMax…) → prompty → výroba → psychologická a etická kontrola.
> Research aktualizovaný v roku 2026 (oficiálne cenníky Google Gemini API, BytePlus ModelArk, MiniMax Open Platform a katalógy Replicate / fal.ai / OpenRouter). Ceny sa menia — vždy si ich over v odkazoch pri každom modeli.

---

## 0. Prehľad celého workflow (pipeline)

```
1. TÉMA + VEK        vyber jednu emóciu/zručnosť na epizódu (nie tri ponaučenia naraz)
2. POSTAVY           hrdina + kamarát + mentor; konzistentný vzhľad = referenčné obrázky + "token"
3. SCENÁR (10 min)   8 beatov (pozri §3) — píšeš raz, používaš ako šablónu série
4. STORYBOARD        12 scén × ~50 s → rozsekaj na klipy podľa limitu modelu (8–30 s)
5. DIALÓGY + PIESEŇ  krátke vety, pieseň v strede epizódy (~5. minúta) ako emočná kotva
6. ANIMATIC PASS     lacný model (Veo Lite / Seedance Mini) — kontrola tempa a emócií
7. FINÁLNY RENDER    kvalitný model; posledný frame klipu N = referencia klipu N+1
8. ZVUK              natívne audio modelu ALEBO vlastné TTS (lepšia slovenčina) + hudba + SFX
9. STRIH + KONTROLA  titulky, bezpečnostná/psychologická kontrola (§8), test s rodičmi
10. PUBLIKÁCIA       YouTube Kids pravidlá, "made for kids", žiadne údaje detí (GDPR/COPPA)
```

**Zlaté pravidlo výroby:** Žiaden súčasný model nevygeneruje 10 minút naraz. 10-minútová rozprávka je **20–75 klipov** poskladaných v editore. Kvalitu nerobí „jeden magický prompt", ale konzistencia postáv, kontinuita framov a disciplinovaný storyboard.

---

## 1. Výskum video-modelov (research)

### 1.1 Google Veo 3.1 (Standard / Fast / Lite) — *odporúčaný hlavný motor na hovoriace postavičky*

- **Dokumentácia:** https://ai.google.dev/gemini-api/docs/video · **Cenník:** https://ai.google.dev/gemini-api/docs/pricing
- **Autentifikácia:** Gemini API kľúč (`x-goog-api-key`), prípadne Vertex AI (GCP service account).
- **Vstupy:** text, referenčné obrázky („Ingredients to Video"), first/last frame, predlžovanie videa.
- **Výstupy:** MP4 720p/1080p/4K, **8 sekúnd**, **natívne audio vrátane dialógov a lip-syncu**.
- **Cena (2026):** Standard $0.40/s (720–1080p), $0.60/s 4K · Fast $0.10/s 720p ($0.12/s 1080p) · Lite $0.05/s 720p.
- **10-minútová epizóda:** 75 klipov. Len Fast ≈ $60 surového renderu; s retry rezervou 1.6× počítaj ~$95. Len Standard ≈ $240 (×1.6 ≈ $385).
- **Silné stránky pre rozprávky:** dialóg priamo v prompte (`Mia says cheerfully: "Poďme spolu!"`), konzistencia cez Ingredients, SynthID vodoznak.
- **Slabiny:** slovenčina v natívnom audiu je nestabilná — pre SK/CZ dabing zváž vlastné TTS (napr. ElevenLabs / MiniMax Speech / Azure) a Veo použi bez dialógov alebo s anglickým „guide" audiom.
- **Parametre:** `seed` podporovaný — uzamkni ho pre sériu záberov v jednej lokácii. Negatívny prompt podporený.

### 1.2 ByteDance Seedance 2.0 / 2.5 — *najlepšie na dlhé zábery a multi-shot strihy*

- **Dokumentácia:** BytePlus ModelArk https://docs.byteplus.com/en/docs/ModelArk · dostupný aj cez Replicate, fal.ai, Runway, Dreamina/CapCut.
- **Autentifikácia:** ModelArk Bearer API kľúč (mimo Číny), Volcano Engine AK/SK (Čína), alebo kľúč agregátora (Replicate `r8_…`).
- **Vstupy:** text (~2000 znakov), **až 12 referencií** (2.0) / až 30 obrázkov + 10 videí + 10 audio (2.5), syntax `@NazovPostavy` priamo v prompte, multi-shot popis („Cut to…").
- **Výstupy:** MP4 H.264/H.265, 480p–1080p (2.0 až 4K), **4–15 s (2.0) / až 30 s (2.5)**, natívne audio, C2PA vodoznak.
- **Cena (2026, orientačne BytePlus):** Seedance 2.0 ≈ $0.07/s 480p, $0.15/s 720p, $0.37/s 1080p; Fast $0.12/s, Mini $0.08/s @720p. Seedance 2.5 ≈ $0.103/s 480p, $0.231/s 720p, $0.569/s 1080p (účtované per video-token; neúspešné generovanie sa neúčtuje). Agregátori (fal) bývajú drahší (~$0.24–0.30/s).
- **10-minútová epizóda pri 2.5 (30 s klipy):** len ~20 klipov → výrazne menej strihov a lepšia kontinuita; 720p ≈ $139 surového renderu.
- **Silné stránky:** multi-shot v jednom klipe, fyzika pohybu, `@referencie` držia postavy a rekvizity, frame-level editácia (2.5).
- **Pozor:** dostupnosť a podmienky sa líšia podľa regiónu (BytePlus sa oficiálne nepredáva v USA); agregátor je často najjednoduchšia legálna cesta.

### 1.3 MiniMax Hailuo 2.3 / H3 (Hailuo 3) — *emócie a „acting", plus open weights*

- **Dokumentácia:** https://platform.minimax.io/docs · **Video cenník:** https://platform.minimax.io/docs/guides/pricing-video
- **Autentifikácia:** Bearer API kľúč (`api.minimax.io`); generovanie je **asynchrónne**: `POST /v2/video_generation` → pollovanie výsledku.
- **Hailuo 2.3:** 6 alebo 10 s, 768p/1080p (1080p len 6 s), **bez natívneho audia**. Cena: $0.28 / 6 s 768p · Fast od $0.19 · $0.49 / 6 s 1080p.
- **H3:** 4–15 s, 768p/2K, 24 fps, **natívne stereo audio**, $0.08/s 768p, $0.13/s 2K; referenčné obrázky prvých 5 zdarma, referenčné audio zdarma. **H3-Base má otvorené váhy (768p)** — jediná plne lokálna cesta.
- **Silné stránky:** výrazná mimika (skvelé na zvieratie emócie), kamerové značky v prompte (`[Push in]`, `[Pan left]`), dobrý Fast tier na drafty.
- **Workflow pre SK:** generuj bez zvuku → vlastné TTS hlasy + MiniMax Music / Suno na pieseň → mix v editore. Získaš 100 % kontrolu nad slovenčinou a výslovnosťou mien postáv.

### 1.4 Ďalšie relevantné modely

| Model | Prístup / docs | Dĺžka klipu | Audio | Cena (orient.) | Ideálne použitie v rozprávke |
|---|---|---|---|---|---|
| **Kling 2.1** (Kuaishou) | Kling API / fal / Replicate | 5–10 s | nie | ~$0.05–0.10/s | Image-to-video zo storyboard panelov, „Elements" konzistencia postáv |
| **Runway Gen-4 / Aleph** | https://docs.dev.runwayml.com | 5–10 s | nie (separate) | kredity; Turbo najlacnejší | Character References naprieč seriálom, dodatočné úpravy hotových záberov |
| **Luma Ray 2** | https://docs.lumalabs.ai / fal | 5–9 s | nie | ~$0.06/s | Keyframes (start/end) — magické prechody medzi scénami, loopy pozadí |
| **Pika 2.2** | Pika / fal | 5 s, Pikaframes do ~25 s | nie | kredity | Spájanie viacerých storyboard obrázkov do jedného plynulého záberu |
| **OpenAI Sora 2** | https://platform.openai.com/docs | do ~25 s | áno | podľa API tieru, limitovaná dostupnosť | Prémiové zábery; v praxi často lepšie využiť OpenAI LLM na scenár a video inde |
| **Wan / LTX / Open-Sora (open-source)** | Hugging Face / ComfyUI | 3–10 s | nie | len GPU čas | Plne lokálna, GDPR-čistá výroba; kvalita a rýchlosť zaostávajú za Veo/Seedance |

### 1.5 Agregátori = skratka k všetkým modelom jedným kľúčom

- **Replicate** (https://replicate.com/docs) — `r8_…` token, overiteľný cez `GET /v1/account`. Seedance, Veo, Kling, Hailuo na jednom účte.
- **fal.ai** (https://docs.fal.ai) — queue API, rýchle nasadenie, zvyčajne prémiová cena.
- **OpenRouter** (https://openrouter.ai/docs) — jeden kľúč na LLM (scenáre) a čoraz viac video-modelov; overiteľný cez `GET /api/v1/auth/key`.

**Odporúčaná kombinácia pre 10-min sériu:** Veo 3.1 Fast (dialógové zábery) + Seedance 2.5 (dlhé snové/piesňové sekvencie) + vlastné SK TTS. Alebo komplet Hailuo H3 + vlastný zvuk pre nižší rozpočet.

### 1.6 Autentifikácia — zhrnutie

Všetci poskytovatelia používajú **Bearer API kľúč v hlavičke** (Google navyše `x-goog-api-key`). Kľúče nikdy nepatria do frontendu ani do gitu — v Rozprávkovo Studio sú uložené **šifrované AES-256-GCM** a overujú sa serverovo (endpoint `/api/api-keys/verify`). Podrobnosti a to, ktorí provideri majú skutočný overovací endpoint, nájdeš v `README.md`.

---

## 2. Definícia témy a cieľového veku

Jedna epizóda = **jedna emócia + jedna zručnosť**. Napr. „strach z tmy + pomenovať pocit a požiadať o svetielko". Ak nevieš tému zhrnúť jednou vetou, je príliš široká.

| Vek | Pozornosť | Štruktúra, ktorá funguje | Čo vynechať |
|---|---|---|---|
| 2–3 r. | 3–5 min, veľmi pomalé | 1 prostredie, 1–2 postavy, rytmus a opakovanie 3× | konflikt, tma, odlúčenie |
| **4–6 r.** | **dokáže 10 min pri zmene záberu každých 20–50 s** | 3–4 prostredia, 3 postavy, úloha + pravidlo troch pokusov | grafické násilie, strašidlo bez humoru |
| 7–9 r. | 10–20 min, vedľajšia línia OK | záhada, mapa, indície, tím | krutosť ako zábava, šikana bez nápravy |

Dialógy pre 4–6 r.: vety do ~8 slov, konkrétne slová („veľký dub") namiesto abstraktných („obrovská entita"), emócie pomenované nahlas, veľa otázok k divákovi s pauzou na odpoveď („Vidíš to? … Áno!").

---

## 3. Scenár — 8 beatov 10-minútovej epizódy

| Čas | Beat | Čo sa deje a prečo |
|---|---|---|
| 0:00–0:40 | **Rituálny otvárak** | Rovnaká znelka série = signál bezpečia. Hrdina predstavený jednou vetou. |
| 0:40–1:30 | **Jemný katalyzátor** | Niečo chýba / je pokazené. Nikdy ohrozenie života. („Dúha stratila žltú!") |
| 1:30–3:30 | **Pokus 1 + smiešne zlyhanie** | Najľahšia cesta zlyhá bezpečne a vtipne. Dieťa internalizuje: chyba ≠ hanba. |
| 3:30–5:30 | **Pokus 2 + kamarát + 🎵 PIESEŇ** | Spolupráca. Pieseň v strede = emočná kotva a pamäťový háčik epizódy. |
| 5:30–7:30 | **Pokus 3 + bezpečné napätie** | Pravidlo troch: tretí pokus s novým poznaním. Napätie nikdy neeskaluj do strachu. |
| 7:30–8:45 | **Rozuzlenie láskavosťou** | Vyhráva všímavosť/láskavosť, nie sila. „Zloduch" dostane meno, motív a pozvánku. |
| 8:45–9:40 | **Tiché zhrnutie** | Jedna veta v piesni/rozprávačovi. Ponaučenie nevysvetľuj — nechaj dieťa domyslieť (Bettelheim). |
| 9:40–10:00 | **Návrat domov** | Späť do bezpečia, záverečný rituál, pozvánka na ďalší diel. Cirkulárna štruktúra upokojuje. |

Naratologické kotvy: **Proppova morfológia** (funkcie: nedostatok → odchod → pomocník → skúška → návrat), „pravidlo troch", cirkulárny návrat domov, rituálne opakovanie (znelka, catch-phrase postavy). Pre sériu drž postavy, prostredie a rituály konštantné — mení sa len emócia/zručnosť epizódy.

---

## 4. Postavy — bibliu postáv a konzistenciu

Pre každú postavu si zapíš (v aplikácii: Prompt Builder → Postavy):

1. **Meno + druh + rola** (hrdina / kamarát-komická úľava / mentor).
2. **Jedna silná vlastnosť + jedna jemná „rastová hrana"** (nie hanobiaca „chyba", ale zručnosť vo vývoji: „učí sa trpezlivosti").
3. **Vzhľad jedinou vetou** — toto je tvoj **consistency token**, napr.:
   `@Mia: small orange fox cub, cream belly, teal scarf, fluffy tail with white tip, same outfit every shot`
4. **Referenčné obrázky**: 3 uhly (front / 3/4 / side) vyrob v obrázkovom modeli a používaj ako Ingredients (Veo), `@Asset` (Seedance) alebo Elements/References (Kling/Runway) v **každom** klipe.
5. **Hlas**: vek, farba, tempo. Mentor pomalší a hlbší než hrdina. Hlas sa v sérii nikdy nemení.

Mentor nikdy nedáva hotovú odpoveď — kladie otázku („Čo myslíš, že les potrebuje?"). Antagonista pre 4–6 r. je „nepochopená postava" (krtko, ktorý kope, lebo stratil okuliare), nie zlo.

---

## 5. Storyboard a dialógy, piesne a zvuky

**Storyboard (12 scén × ~50 s)** je pracovný dokument — každá scéna má: vizuálny popis (budúci video-prompt), kameru, emóciu, rozprávača, dialóg, hudbu a SFX. V aplikácii ho vygeneruješ z témy jedným klikom a potom ručne ladíš.

Kamera pre deti: **pomalé pohyby, výška očí dieťaťa**, maximálne ~1 strih/4 s (2–3 r.) resp. /2–3 s (4–6 r.), žiadne rýchle whip-pany ani stroboskopické prechody.

**Pieseň epizódy** (Suno / MiniMax Music / ľudský skladateľ):
- 90–105 BPM, durová tónina, melódia v rozsahu jednej oktávy, refrén ≤ 4 verše, slová do 2 slabík.
- Štruktúra: sloka → refrén (call-and-response „Spievaj s nami!") → tichý bridge (emócia nahlas) → refrén hlasnejšie.
- Refrén nesie ponaučenie lepšie než akýkoľvek monológ — deti si ho pamätajú týždne.

**Zvukový dizajn:** SFX sú jemné a rozpoznateľné (vtáčiky, kroky na machu, zvonček pri „aha!" momente). Konštantné zvukové signály fungujú ako kotvy: rovnaký „tadá!" zvuk pri každom úspechu. Hudba kopíruje emočný oblúk, nikdy „straší" disonanciou u detí do 6 rokov.

---

## 6. Psychologické a etické princípy (nevyjednávateľné)

Vychádza z detskej vývojovej psychológie a Bettelheimovho *The Uses of Enchantment* (rozprávka dáva detským úzkostiam symbolický tvar, ktorý vie psychika spracovať; zmysel si dieťa musí nájsť samo — preto rozprávku nikdy „nevysvetľujeme"):

1. **Bezpečná základňa:** príbeh začína a končí doma/v bezpečí. Odlúčenie má vždy viditeľný návrat.
2. **Žiadne grafické násilie, zbrane, krv, sexualita, látky.** Konflikt rieši láskavosť, šikovnosť, humor.
3. **Dávkovaný strach:** napätie vyvaž do 30–60 s svetlom/humorom/objatím. Strašidelné ≠ traumatizujúce.
4. **Restoratívny koniec:** „zlá" postava dostane meno, dôvod a miesto v komunite. Trest = náprava, nie pomsta.
5. **Emócie nahlas:** „Pim sa cíti smutný. Je to v poriadku cítiť sa smutne." Buduje emočnú gramotnosť (SEL).
6. **Chyba = informácia, nikdy hanba.** Žiaden výsmech za vzhľad, reč, strach či neúspech.
7. **Pozitívna emočná nálož > poučovanie.** Moralitu ukáž dejom; prednáška na konci ničí identifikáciu s hrdinom.
8. **Konzistentnosť = bezpečnosť:** rovnaká postava, hlas, rituály a pravidlá sveta v celej sérii. Porušenie konzistencie deti zneisťuje (aj preto na nej záleží technicky pri AI videu).
9. **Reprezentácia bez stereotypov:** postavy sa líšia schopnosťami, nie „hodnotou". Každá schopnosť raz zachráni situáciu.
10. **GDPR / COPPA:** žiadne reálne mená, fotky ani hlasy detí v promptoch a referenciách. Iba fiktívne postavy. Publikácia ako „made for kids" má vlastné pravidlá (vypnuté komentáre, obmedzená reklama) — počítaj s tým v biznis modeli.

Bezpečnostný skener v aplikácii (záložka Bezpečnosť) tieto princípy kontroluje automaticky na úrovni textu — nenahrádza však ľudskú kontrolu finálneho strihu dospelým.

---

## 7. Praktické použitie modelov — parametre, seed, kvalita

**Univerzálny recept na prompt jedného klipu:**

```
[consistency token postavy] + [akcia jednou vetou] + [prostredie + svetlo] +
[emócia na tvári] + [kamera] + [štýl] + (Veo: dialóg v úvodzovkách) + [negative]
```

Negative prompt (používaj konzistentne): `scary, horror, violence, weapon, dark atmosphere, morphing character design, inconsistent outfit, extra limbs, distorted face, text, watermark, fast cuts`

- **Seed:** fixuj pre lokáciu, meň pri zmene prostredia. Seed si zapisuj k záberu (aplikácia ho ukladá v `params`) — reprodukovateľnosť šetrí peniaze.
- **Rozlíšenie:** draftuj v 480–720p, finál 1080p. Upscale je lacnejší než 4K render.
- **Kontinuita:** posledný frame klipu N ulož ako obrázok → first-frame / referencia klipu N+1 (Veo frames, Luma keyframes, Seedance extension).
- **Rozpočet:** počítaj 1.5–2× surového renderu na retry. Pracovný odhad pre 10 min: Veo Lite animatic ~$30 → Veo Fast finál ~$60–95 → voliteľne hero-zábery vo Veo Standard. Seedance 2.5 720p ~$139. Hailuo 2.3 (10 s klipy, 60 klipov) ~$17–34 bez audia + vlastné TTS/hudba.
- **API tok (všetci):** submit prompt → job id → polling každých 5–10 s → download MP4 → ďalší klip. Nikdy nevolaj video API synchrónne z webového requestu — použij workera/frontu.
- **Rate limity:** generovanie epizód plánuj v dávkach; agregátori mávajú paralelné limity (5–20 behov). 75 klipov Veo pri 5 paralelných behoch ≈ desiatky minút.

---

## 8. Kontrolný zoznam pred publikáciou

- [ ] Bezpečnostné skóre scenára ≥ 85 a žiadny „block" flag (aplikácia → Bezpečnosť)
- [ ] Každé napätie vyvážené do 60 s; epizóda končí doma, v pokoji
- [ ] Postavy vyzerajú identicky v 1. a poslednom klipe (porovnaj framy vedľa seba)
- [ ] Hlasy a výslovnosť mien konzistentné; žiadne „uncanny" artefakty v tvárach
- [ ] Tempo strihu primerané veku; žiadne blikanie > 3×/s (fotosenzitivita!)
- [ ] Hlasitosť vyrovnaná, žiadne náhle hlasné SFX
- [ ] Titulky pre nepočujúce deti/rodičov; kontrastný text, veľké písmo
- [ ] Testovacie pozretie s 2–3 rodičmi cieľového veku; sleduj nezáujem/strach v tvári dieťaťa, nie len spätnú väzbu dospelých
- [ ] Práva: modely povoľujú komerčné použitie podľa tvojho tarifu — over ToS; AI obsah označ podľa pravidiel platformy
- [ ] Žiadne osobné údaje detí nikde v metadátach, promptoch ani komentároch

---

## Zdroje (research 2026)

- Google Gemini API — video generation & pricing: https://ai.google.dev/gemini-api/docs/video · https://ai.google.dev/gemini-api/docs/pricing
- BytePlus ModelArk (Seedance): https://docs.byteplus.com/en/docs/ModelArk · prehľad cien 2.5: https://openrouter.ai/bytedance/seedance-2.5
- MiniMax Open Platform — video pricing: https://platform.minimax.io/docs/guides/pricing-video
- Replicate / fal.ai / Runway Dev API: https://replicate.com/docs · https://docs.fal.ai · https://docs.dev.runwayml.com
- Luma: https://docs.lumalabs.ai
- Bruno Bettelheim, *The Uses of Enchantment* (psychológia rozprávky); Vladimir Propp, *Morfológia rozprávky* (31 funkcií).
- Porovnania cien modelov (sekundárne): CloudZero Veo 3 pricing 2026, invideo AI video model pricing — ceny si vždy over u providera.
