---
title: Lühivideote töövoog
description: Eric Siu oskus lühivideote tootmiseks.
category: Marketing
sublabel: Strateegia
author: Eric Siu
tags: 
license: MIT
source: https://github.com/ericosiu/ai-marketing-skills
---

# Lühivormi videoklippide konveier — oskus

## Sissejuhatus (käivitub oskuse alustamisel)

```bash
# Version check (silent if up to date)
python3 telemetry/version_check.py 2>/dev/null || true

# Telemetry opt-in (first run only, then remembers your choice)
python3 telemetry/telemetry_init.py 2>/dev/null || true
```

> **Privaatsus:** See oskus logib kasutust lokaalselt kausta `~/.ai-marketing-skills/analytics/`. Kaugtelemeetria on ainult vabatahtlik (opt-in). Koodi, failiteid ega repo sisu kunagi ei koguta. Vaata `telemetry/README.md`.

---

Eralda pikkadest YouTube'i videotest viraalseid lühivormiklippe (TikTok, Reels, Shorts). Käsitleb allalaadimist, transkribeerimist, AI-segmenteerimist, lõikamist, vertikaalset kadreerimist ja subtiitrite sissepõletamist.

## Eeltingimused

- `yt-dlp` ja `ffmpeg` paigaldatud
- `ANTHROPIC_API_KEY` keskkonnamuutuja seatud
- Pythoni sõltuvused failist `requirements.txt` paigaldatud
- Valikuline: `mediapipe` ja `opencv-python` näotuvastusega nutika kadreerimise jaoks

## Kiire algus

### Üksik video → klipid

```bash
python3 scripts/shortform_pipeline.py \
  --url "https://www.youtube.com/watch?v=VIDEO_ID" \
  --max-clips 3 \
  --output-dir ./output
```

### Eraldiseisev klipper (ilma Claude'ita, heuristiline hindamine)

```bash
python3 scripts/video_clipper.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
```

## Konveieri ülevaade

1. **Allalaadimine** — yt-dlp tõmbab video + automaatselt genereeritud VTT-subtiitrid
2. **Transkribeerimine** — Whisper genereerib sõnatasandi ajatemplid (taandub YouTube'i subtiitritele)
3. **Segmenteerimine** — Claude tuvastab 2–5 parimat 30–60-sekundilist hetke, mille konksuhinne on ≥7/10
4. **Lõike kontroll** — Teine Claude'i läbimine kontrollib, et iga klipp lõpeb lõpetatud mõttel
5. **Lõikamine** — FFmpeg eraldab iga klipi lähtevideost
6. **Vertikaalne kadreerimine** — Paigutusteadlik 16:9 → 9:16 teisendus näotuvastusega
7. **Subtiitrite põletamine** — TikToki-stiilis sõnade esiletõstmisega subtiitrid (ASS-vorming) põletatakse sisse

## Põhifailid

| Fail | Otstarve |
|------|---------|
| `scripts/shortform_pipeline.py` | Täiskonveier: allalaadimine → segmenteerimine → lõikamine → kadreerimine → subtiitrid |
| `scripts/video_clipper.py` | Eraldiseisev klipper heuristilise hindamisega (Claude'i pole vaja) |
| `scripts/clip_sender.py` | Abivahend klippide edastamiseks ja ülevaatuse töövooks |

## Paigutusteadlik kadreerimine

Konveier käsitleb nelja videopaigutust erinevalt:

- **`talking_head`** — Näotuvastusega keskele kadreerimine MediaPipe'iga; heli panoraamimine varulahendusena
- **`screen_share_overlay`** — Ekraani sisu üleval, veebikaamera mull all
- **`side_by_side`** — Ekraan üleval, esineja nägu all
- **`gallery_view`** — Kadreeritakse aktiivse kõneleja kvadranti

Claude väljastab segmenteerimise käigus igale segmendile `layout_hint`'i.

## Kohandamine

### Kõnemustrid
Muuda `VOICE_PATTERNS`'i failis `video_clipper.py`, et see sobiks sinu looja kõnemustritega. Need tõstavad autentselt kõlavate segmentide klipihinnet.

### Segmenteerimise päring
Claude'i päringut failis `shortform_pipeline.py` saab kohandada:
- Reguleeri `hook_strength`'i miinimumi (vaikimisi: 7/10)
- Muuda sihtkestuse vahemikku (vaikimisi: 30–60 s)
- Muuda paigutusvihje valikuid

### Kadreerimise häälestus
Failis `video_clipper.py`:
- `scale_factor` — Üksiku näo suumitase (vaikimisi: 1.08)
- `desired_face_y` — Näo sihtpositsioon kaadris (vaikimisi: ülemine 35%)

## Väljund

Iga klipp väljastatakse järgmiselt:
- **1080×1920** lahutusvõime (9:16 vertikaalne)
- **H.264 + AAC** kodeering
- **Sõnade esiletõstmisega subtiitrid** sisse põletatud
- Valmis otse üleslaadimiseks TikToki, Reelsi või Shortsi

## Veaotsing

- **FFmpegi filter_complex viga:** Ära kasuta `-c:v copy` koos `-filter_complex`'iga. Ohutu on ainult `-c:a copy`.
- **Vale väljundi lahutusvõime:** Kadreeri alati enne skaleerimist. Kontrolli käsuga `ffprobe -show_entries stream=width,height`.
- **Subtiitrite sünkroonimise probleemid:** Käivita Whisper lõigatud klipil, mitte lähteepisoodil.
- **TikToki üleslaadimine ebaõnnestub:** Veendu, et kodeering on H.264 + AAC. Vajadusel lisa `-c:v libx264 -c:a aac`.
- **Klipp liiga pikk:** Claude mõnikord liialdab. Konveier kärbib automaatselt >90 s klipid 75 sekundile.