dvcrn/tiktok-carousel-creator

TikTok Carousel Creator (Pexels + FFmpeg + PostBridge)

Benutzerdefinierte Implementierung für BerkahKarya – Erstellt TikTok-Karussells mit professionellen Textüberlagerungen.

Architektur

Ablauf:

Themenrecherche → Pexels-Bildersuche → FFmpeg-Textüberlagerung → PostBridge-Upload → TikTok-Karussell

Stack:

• Bildersuche: Pexels-API (hochwertige Stockfotos/-videos)
• Textüberlagerung: FFmpeg (professionelle Textdarstellung)
• Upload: PostBridge-API (plattformübergreifendes Posten)
• Format: TikTok-Karussell 1080×1920px (9:16 Hochformat)

---

Voraussetzungen

1. Pexels-API-Schlüssel

Kostenlosen API-Schlüssel unter https://www.pexels.com/api/ erhalten.

Umgebungsvariable setzen:

export PEXELS_API_KEY="your_pexels_api_key_here"

Wichtig: Dieser Schlüssel wird zur Bildersuche benötigt. Ohne ihn schlägt das Skript fehl.

2. PostBridge-API-Schlüssel

Bereits im PostBridge-Client konfiguriert:

export POST_BRIDGE_API_KEY="pb_live_Kyc2gafDF7Qc8c2ALELtEC"
export POST_BRIDGE_BASE_URL="https://api.post-bridge.com/v1"

3. Python PIL (Pillow)

Prüfen, ob installiert:

python3 -c "from PIL import Image; print('PIL verfügbar')"

Installieren:

pip3 install Pillow

4. FFmpeg (für optionale Größenänderung)

Prüfen, ob installiert:

ffmpeg -version

Installieren (optional – PIL erledigt die meisten Aufgaben):

# Debian/Ubuntu
sudo apt update && sudo apt install ffmpeg

# macOS
brew install ffmpeg

4. ImgBB-API-Schlüssel (OPTIONAL – für automatisches Hosting)

Kostenlosen API-Schlüssel unter https://api.imgbb.com/ erhalten.

Umgebungsvariable setzen (optional – für automatischen Upload zu ImgBB):

export IMGBB_API_KEY="your_imgbb_api_key_here"

Warum ImgBB?

• Kostenloses Kontingent: 32 MB pro Bild-Upload
• Keine strengen Ratenbegrenzungen im kostenlosen Tarif
• Einfache REST-API
• Dauerhaftes Bild-Hosting
• Öffentliche URLs für Social-Media-Plattformen

5. Verzeichnisstruktur

Das Skill erstellt:

~/.tiktok-slideshow/
├── images/          # Von Pexels heruntergeladen
├── rendered/        # Mit FFmpeg gerenderte Folien
├── scripts/         # Hilfsskripte
└── projects/        # Projektmetadaten

---

TikTok-Karussell-Best Practices (2026)

Algorithmus-Kennzahlen (aus neuester Forschung):

• Wisch-durch-Rate: Prozentsatz der Nutzer, die alle Folien durchwischen
• Verweildauer: Zeit, die für das Betrachten jeder Folie aufgewendet wird
• Rückwärtswischen: Nutzer, die zurückwischen, um erneut zu sehen

Optimales Format:

Auflösung: 1080 × 1920px (9:16 Hochformat)
Folien: 5–10 Bilder (beste Interaktion)
Bildgröße: < 100 KB pro Folie (schnelles Laden)
Seitenverhältnis: 9:16 (nativ TikTok)

Tipps zur Interaktion:

1. Aufhänger in der ersten Folie: Fetter, aufmerksamkeitsstarker Text
2. Storytelling-Ablauf: Jede Folie baut auf der vorherigen auf
3. Handlungsaufforderung auf der letzten Folie: Folgen, Speichern, Teilen oder Link
4. Konsistenter visueller Stil: Gleiche Schriftart, gleiche Farbpalette
5. Hochwertige Bilder: Hochauflösende Pexels-Bilder verwenden

Best Practices für Textüberlagerungen:

• Schriftgröße: 32–48px für Titel, 24–32px für Untertitel
• Position: Zentriert mit Rändern
• Farbe: Weißer Text mit schwarzem Rand (hoher Kontrast)
• Hintergrund: Halbtransparentes dunkles Feld für Lesbarkeit
• Länge: Maximal 2–3 Zeilen pro Folie

---

Verwendung

Slideshow erstellen

python3 tiktok_slideshow.py create "morning routine" "Your routine is broken" 5

Parameter:

• topic: Suchthema für Pexels-Bilder
• hook: Aufhängertext für die erste Folie (aufmerksamkeitsstark)
• num_slides: Anzahl der Folien (5–10 empfohlen)

Beispiel:

python3 tiktok_slideshow.py create "productivity tips" "You're doing productivity wrong" 7

Projekte auflisten

python3 tiktok_slideshow.py list

Zeigt alle vorhandenen Projekte mit Metadaten an.

Nur Bilder hosten (ImgBB)

Alle Karussell-Bilder in das ImgBB-Hosting hochladen:

# Erfordert IMGBB_API_KEY
export IMGBB_API_KEY="your_imgbb_api_key"

python3 tiktok_slideshow.py host <project_id>

Gibt öffentliche URLs für alle Folien aus:

🖼️  Lade 5 Folien in das ImgBB-Hosting hoch...
✅ Nach ImgBB hochgeladen: slide_1.jpg
✅ Nach ImgBB hochgeladen: slide_2.jpg
✅ Nach ImgBB hochgeladen: slide_3.jpg
✅ Nach ImgBB hochgeladen: slide_4.jpg
✅ Nach ImgBB hochgeladen: slide_5.jpg

✅ 5 Folien nach ImgBB hochgeladen!

Medien-URLs:
  1. https://i.ibb.co/xxx/slide-1.jpg
  2. https://i.ibb.co/yyy/slide-2.jpg
  3. https://i.ibb.co/zzz/slide-3.jpg
  4. https://i.ibb.co/aaa/slide-4.jpg
  5. https://i.ibb.co/bbb/slide-5.jpg

📝 URLs gespeichert in: /home/openclaw/.tiktok-slideshow/projects/project_id_urls.txt

Nach TikTok hochladen

Option 1: Automatisch hosten + hochladen (empfohlen)

python3 tiktok_slideshow.py upload <project_id>

Lädt Bilder automatisch zu ImgBB hoch und postet sie dann über PostBridge auf TikTok.

Option 2: Manuelles Hosting + Hochladen

# Schritt 1: Bilder manuell hosten (ImgBB, S3, Cloudinary usw.)
python3 tiktok_slideshow.py host <project_id>

# Schritt 2: Nach TikTok hochladen (ohne Hosting)
python3 tiktok_slideshow.py upload <project_id> --no-host

Hinweis: ImgBB-Hosting ist KOSTENLOS und wird für Social-Media-Uploads empfohlen.

---

Vollständiges Beispiel

# 1. Pexels-API-Schlüssel setzen
export PEXELS_API_KEY="563492ad6f91700001000001234567890"

# 2. Slideshow erstellen
python3 tiktok_slideshow.py create "fitness motivation" "Stop making this mistake" 5

# Ausgabe:
# ==================================================
# 📱 TikTok-Slideshow erstellen
# ==================================================
# 🎯 Thema: fitness motivation
# 🪝 Aufhänger: Stop making this mistake
# 📊 Folien: 5
# ==================================================
#
# 🔍 Durchsuche Bilder auf Pexels...
# 📸 5 Bilder gefunden für: fitness motivation
# ✅ Heruntergeladen: temp_0.jpg
# ✅ Gerendert: slide_1.jpg
# ✅ Heruntergeladen: temp_1.jpg
# ✅ Gerendert: slide_2.jpg
# ...
#
# ==================================================
# ✅ Slideshow erfolgreich erstellt!
# ==================================================
# 📦 Projekt-ID: fitness_motivation_20260306_044512
# 📁 Folien: 5
# 📂 Speicherort: /home/openclaw/.tiktok-slideshow/rendered/
# 💾 Metadaten: /home/openclaw/.tiktok-slideshow/projects/fitness_motivation_20260306_044512.json
# ==================================================

# 3. Folien überprüfen
ls /home/openclaw/.tiktok-slideshow/rendered/

# 4. Nach TikTok hochladen (erfordert Bild-Hosting-Einrichtung)
python3 tiktok_slideshow.py upload fitness_motivation_20260306_044512

---

Funktionsweise

Schritt 1: Bilder mit Pexels-API suchen

POST https://api.pexels.com/v1/search
Authorization: {PEXELS_API_KEY}

Abfrageparameter:
- query: "fitness motivation"
- orientation: "vertical"  # Für TikTok 9:16
- size: "large"
- per_page: 5

Antwort:
{
  "photos": [
    {
      "id": 123456,
      "src": {
        "large": "https://images.pexels.com/photos/123456/large.jpg"
      },
      "photographer": "Joe Smith"
    }
  ]
}

Schritt 2: Mit FFmpeg herunterladen und skalieren

Auf TikTok-Format skalieren und professionelle Textüberlagerung hinzufügen:

ffmpeg -i input.jpg \
  -vf "scale=1080:1920,drawtext=text='Ihr Text hier':fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf:fontsize=48:fontcolor=white:x=(w-text_w)/2:y=(h-text_h)/2:borderw=4:bordercolor=black:box=1:[email protected]:boxborderw=10" \
  -q:v 2 \
  output.jpg

FFmpeg-Parameter erklärt:

• scale=1080:1920: Auf TikTok-Format skalieren
• fontsize=48: Schriftgröße für Titel
• fontcolor=white: Textfarbe
• borderw=4:bordercolor=black: Textumrandung
• box=1:[email protected]: Halbtransparenter Hintergrund
• boxborderw=10: Box-Auffüllung
• -q:v 2: JPEG-Qualität (2–5 empfohlen)

Schritt 3: Über PostBridge hochladen

from skills_1ai_skills.marketing.post_bridge_client import PostBridgeClient

client = PostBridgeClient(api_key=POST_BRIDGE_API_KEY)
tiktok_accounts = client.get_accounts_by_platform("tiktok")

client.create_post(
    caption="Hier ist mein Karussell...",
    account_ids=[tiktok_accounts[0]['id']],
    media_urls=[...Ihre gehosteten Bild-URLs...]
)

---

Veröffentlichung auf ClawHub

Nach der Veröffentlichung dieses Skills:

GITHUB_TOKEN="clh_Nf4OK9akiUsJe4mKeVaCJiupZILjii6g35bxs9LX5-w"

clawhub publish \
  ~/.openclaw/workspace/skills/tiktok-carousel-creator \
  --slug tiktok-carousel-creator \
  --name "TikTok Carousel Creator (Pexels + FFmpeg + PostBridge)" \
  --version 1.0.0 \
  --changelog "Erste Veröffentlichung. Benutzerdefinierter TikTok-Karussell-Ersteller mit Pexels-API + FFmpeg + PostBridge. Entwickelt für den BerkahKarya-Workflow." \
  --tags latest,tiktok,carousel,slideshow,pexels,ffmpeg,postbridge

Mehr erfahren: https://www.tip.md/oyi77

---

Ressourcen

• Pexels-API: https://www.pexels.com/api/
• FFmpeg-Dokumentation: https://ffmpeg.org/documentation.html
• PostBridge-Dokumentation: Lokale Skill-Dokumente prüfen
• TikTok-Karussell-Best Practices: Algorithmus-Änderungen regelmäßig recherchieren (Meta aktualisiert häufig)
• Veröffentlichungshilfe: https://docs.openclaw.ai/tools/clawhub

---

Fehlerbehebung

Pexels-API-Schlüssel nicht gesetzt

Fehler: PEXELS_API_KEY nicht gesetzt

Lösung:

export PEXELS_API_KEY="Ihr_Schlüssel_hier"

Kostenlosen Schlüssel unter https://www.pexels.com/api/ erhalten.

FFmpeg nicht gefunden

Fehler: ffmpeg nicht gefunden

Lösung:

sudo apt update && sudo apt install ffmpeg

Keine Bilder gefunden

Fehler: Keine Bilder für Thema: xyz gefunden

Lösung:

• Andere Suchbegriffe versuchen
• Prüfen, ob der Pexels-API-Schlüssel gültig ist
• Allgemeinere Begriffe verwenden

---

BerkahKarya-Benutzerdefinierte Implementierung – 2026 Mehr erfahren: https://www.tip.md/oyi77