Lühivormi videoklippide konveier — oskus

Sissejuhatus (käivitub oskuse alustamisel)

# 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

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)

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

Konveieri ülevaade

Allalaadimine — yt-dlp tõmbab video + automaatselt genereeritud VTT-subtiitrid
Transkribeerimine — Whisper genereerib sõnatasandi ajatemplid (taandub YouTube'i subtiitritele)
Segmenteerimine — Claude tuvastab 2–5 parimat 30–60-sekundilist hetke, mille konksuhinne on ≥7/10
Lõike kontroll — Teine Claude'i läbimine kontrollib, et iga klipp lõpeb lõpetatud mõttel
Lõikamine — FFmpeg eraldab iga klipi lähtevideost
Vertikaalne kadreerimine — Paigutusteadlik 16:9 → 9:16 teisendus näotuvastusega
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.

Lühivideote töövoog