---

Name: Buch-Video-Pipeline

Beschreibung: „Xiaohongshu Buchempfehlungs-Video-Automatisierung v3 – Seedance 2.0: Originalton + Untertitel, vollautomatisiert von der Buchauswahl bis zur Veröffentlichung“

Lizenz: MIT

invoke: "/book-video

---

# Xiaohongshu Buchempfehlungsvideo Automatische Pipeline-Generierung v3

book-video-pipeline

## Übersicht

Ein vollautomatisierter Prozess zur Generierung von Buchempfehlungsvideos für Xiaohongshu basierend auf der Seedance 2.0 API von Volcano Ark.

**Verbesserungen in Version 3 (basierend auf dem offiziellen Prompt-Wortleitfaden):**

- **Native Audio** — Geben Sie die Sprachausgabe direkt in der Eingabeaufforderung an, und Seedance generiert die Stimme automatisch (ohne edge-tts zu verwenden).

- **Native Subtitles** — Geben Sie den Untertitelinhalt in der Eingabeaufforderung an, und Seedance generiert synchronisierte Untertitel innerhalb des Videos.

- **Titelkarte auf dem Cover** — Schwenk-/Zoom-Effekt + stumme Tonspur, um Kompatibilität beim Zusammenschneiden zu gewährleisten.

- **Kettengenerierung** — Jedes Segment verwendet das letzte Bild des vorherigen Segments als Startbild, was zu einem kohärenteren visuellen Fluss führt.

- **Überblendung** — Video-Überblendung + Audio-Überblendung für synchronisierte audiovisuelle Übergänge.

**Kernprozess:** Buchauswahl → Details/Cover → Drehbuch → Storyboard → Videoerstellung (inkl. Audio und Untertitel) → Zusammenfügen → Vorschau → Veröffentlichung

---

## Protokoll für stille Ausführung

Bitten Sie nicht um eine Bestätigung, um fortzufahren.

Die gesamte Ausgabe in einem Schritt generieren.

Falls Daten fehlen, werden die definierten Standardwerte verwendet.

- Vermeiden Sie unterbrechende Formulierungen wie „Möchten Sie fortfahren?“, „Brauchen Sie meine Hilfe?“ oder „Bitte bestätigen Sie“.

---

## Umweltanforderungen

| Abhängigkeiten | Installation |

|------|------|

| Volcano Ark API-Schlüssel | Umgebungsvariable `VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg` (wird mit ffmpeg mitgeliefert) |

| Docker (xiaohongshu-mcp) | Erfordert die Bereitstellung auf `localhost:18060` |

---

## Ausführungsprozess

**Trigger-Methode: `/book-video` oder `/book-video 《Buchtitel》`**

Schritt 1: Bücher auswählen

**Szenario A - Der Benutzer hat einen Buchtitel angegeben:** Verwenden Sie ihn direkt.

**Szenario B – Kein Buchtitel angegeben:** Suchskript ausführen (Priorisierung von Bestsellern mit geringem Suchvolumen):

bash

python "D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py"

```

Automatische Auswahl des Top 1 aus der Kategorie „Low-Powder Bestseller“ (ausgenommen „[Veröffentlicht]“).

**Fehlerbehandlung:** Skript-Timeout → Cache → Websuche → Standard (Der Mut, nicht gemocht zu werden)

---

Schritt 2: Buchdetails und Cover besorgen

**2.1 Details von Douban einholen**

```

WebFetch: https://search.douban.com/book/subject_search?search_text={Buchtitel}

Auszug: Buchtitel, Autor, Douban-Bewertung, Inhaltsangabe, Schlüsselzitate/Kernaussagen, URL des Covers

```

**2.2 Laden Sie das Cover herunter (englischer Dateiname!)**

bash

curl -o "D:\xiaohongshu_data\cover_{english_name}.jpg" -H "Referer: https://book.douban.com/" "Cover URL"

```

Falls curl fehlschlägt, verwenden Sie Folgendes:

bash

python "D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py" "{Buchtitel}"

```

---

Schritt 3: Buchempfehlungsskript + Storyboard erstellen

Erstellen Sie ein dialogisches Videoskript basierend auf den Buchdetails.

**Callergieformel (basierend auf dem offiziellen Seedance 2.0-Leitfaden):**

Jede Storyboard-Vorgabe besteht aus drei Teilen:

1. **Audiobefehle** — Erzeugt ein Video mit Sprachausgabe. Ein `{voice_type}` würde sagen: "Erzähltext".

2. **Visuelle Beschreibung** — „Motiv + Handlung + Umgebung + Kamerabewegung + Atmosphäre“

3. **Untertitelhinweise** – Die Untertitel erscheinen am unteren Bildschirmrand. Die Untertitel sind „Erzähltext“ und müssen exakt mit dem Audiorhythmus synchronisiert sein.

**Drehbuchvorlage (6-7 Szenen, ca. 35 Sekunden):**

```Markdown

## Skript für ein Buchempfehlungsvideo

**Buchtitel**: 《{Buchtitel}》

**Stil:** Heilend (Warme Goldtöne)

### Szene 1 - Eröffnungsspannung (5 Sekunden)

**Erzählung:** {Ein einprägsamer Eröffnungssatz}

**Visuelle Beschreibung:** {50-80 Wörter auf Englisch: Motiv + Handlung + Umgebung + Kameraeinstellung + Atmosphäre}

### Szene 2 - Bücher erscheinen (5 Sekunden)

**Erzähler:** {Eine kurze Einführung in dieses Buch}

**Visuelles:** {Auf Englisch, eine Szene mit Bezug zu Büchern}

### Storyboard 3 - Autor/Hintergrund (5 Sekunden)

**Erzählung:** {Hintergrundgeschichte oder kreative Erzählung des Autors}

**Szene**: {Englisch, Schreibumgebung, Studium usw.}

### Storyboard 4 - Kernperspektive 1 (5 Sekunden)

**Erzählung:** {Eine berührende Sichtweise oder einprägsames Zitat}

**Visuelle Elemente:** {Im Englischen: visuelle Metaphern, die dem Standpunkt entsprechen}

### Szene 5 - Kernperspektive 2 (5 Sekunden)

**Erzählung:** {Ein weiterer überzeugender Standpunkt oder einprägsames Zitat}

**Visuelle Elemente:** {Im Englischen: visuelle Metaphern, die dem Standpunkt entsprechen}

### Storyboard 6 - Persönliche Reflexionen (5 Sekunden)

**Erzähler**: {Meine wahren Gefühle, die Veränderungen, die ich nach dem Lesen erlebt habe}

**Visuelle Elemente:** {Englisch, emotionale Szene}

### Szene 7 - Handlungsaufforderung (5 Sekunden)

**Erzähler:** {Aufruf zum Handeln}

**Visuelle Elemente:** {Englisch, eine herzerwärmende Schlussszene}

```

**Regeln für die Bildschirmbeschreibung:**

- **Muss auf Englisch sein**, 50-80 Wörter

- Gemäß der Formel: Subjekt + Welche Handlung wird ausgeführt + In welcher Umgebung findet sie statt + In welcher Beleuchtung/Atmosphäre herrscht sie + Wie bewegt sich die Kamera?

- **Das Coverbild/der Buchtitel darf nicht erwähnt werden** (Text wird aus den Untertiteln generiert)

- Beschreiben Sie möglichst konkrete Szenarien und vermeiden Sie abstrakte Konzepte.

**Optionale Soundtypen:**

- Heilung: „Sanfte und ruhige Frauenstimme“

- Spannung/Geheimnis: „Tiefe, leise Männerstimme“

- Frischer und klarer Stil: Eine leichte und lebhafte Frauenstimme.

---

Schritt 4: Verwenden Sie die Pipeline, um Videos zu generieren.

**4.1 Storyboard-JSON speichern**

JSON

[

{"scene_id": 1, "prompt": "Englische visuelle Beschreibung...", "narration": "Chinesische Erzählung"},

{"scene_id": 2, "prompt": "Englische visuelle Beschreibung...", "narration": "Chinesische Erzählung"},

...

]

```

Speichern Sie unter `D:\xiaohongshu_data\storyboard_{english_name}.json`.

**4.2 Aufruf der kompletten Pipeline v3**

Python

import sys, json

sys.path.insert(0, r"D:\skills\book-video-pipeline\scripts")

from seedance_client import SeedanceClient

client = SeedanceClient(api_key="YOUR_API_KEY")

with open(r"D:\xiaohongshu_data\storyboard_xxx.json", encoding="utf-8") as f:

storyboard = json.load(f)

result = client.generate_full_video(

Storyboard = Storyboard,

cover_path=r"D:\xiaohongshu_data\cover_xxx.jpg",

book_title="Buchtitel",

output_dir=r"D:\xiaohongshu_data",

voice_type="sanfte und ruhige Frauenstimme",

with_subtitles=True,

)

print(f"Video: {result['video_path']} ({result['size_kb']}KB, ~{result['duration']}s, audio: {result['has_audio']})")

```

**Pipeline v3 wird automatisch ausgeführt:**

1. Cover → Titelkarte (3-Sekunden-Schwenk/Zoom + Stummschaltung der Tonspur)

2. Generieren Sie nacheinander Videoclips (jeder Clip enthält Originalton und Untertitel).

3. Überblendung (Videoüberblendung + Audioüberblendung)

4. Das endgültige Video ausgeben.

**API-Schlüsselkonfiguration:**

bash

set VOLCENGINE_API_KEY=ark-xxx

```

---

### Schritt 5: Vorschau

Generieren Sie eine HTML-Vorschauseite `D:\preview_video_{name}_{date}.html`, die Folgendes enthält:

- Videoplayer

Buchtitel, Autor, Bewertung

- Erzähltextversion

- Pinkfarbene Styles auf Xiaohongshu

bash

start "" "D:\preview_video_xxx.html"

```

**Bitte bestätigen Sie dies mit dem Nutzer.** Bei Unzufriedenheit wenden Sie sich bitte an:

- Storyboard-Eingabeaufforderung anpassen → Neu generieren

- Soundtyp ändern → Regenerieren

- Visuelle Beschreibung anpassen → Nur die Eingabeaufforderung ändern

---

Schritt 6: Auf Xiaohongshu veröffentlichen

**6.1 Anmeldestatus prüfen** → MCP `check_login_status`

**6.2 Videonotizentext generieren** (Kein Videoskript!)

- Titel ≤ 20 Zeichen, Ich-Perspektive mit Emotionen

- 200-300 Wörter im Haupttext, 20+ Emojis

- 10-15 Tags mit #

**MCP Version 6.3 veröffentlicht**

Python

MCP_URL = 'http://localhost:18060'

# Initialisierung → publish_content(title, content, video, tags)

# Videopfad unter Verwendung des Containerpfads: /app/data/xxx.mp4

```

**6.4 Datensatz wurde veröffentlicht** → Füge `"type": "video"` zu `published_books.json` hinzu.

---

## Ausgabeformat

```Markdown

## Buchempfehlungsvideo erfolgreich generiert

**Buchtitel**: 《{Buchtitel}》

**Autor**: {Autor} | **Douban**: {Bewertung}

### Videoinformationen

- Dauer: ~{N} Sekunden (3 Sekunden Titelkarte + {M} Szenen x 5 Sekunden)

- Seitenverhältnis: 9:16 (Hochformat)

- Auflösung: 720p

- Dateigröße: {N} MB

- Audio: Ja/Nein

- Untertitel: Eingebettet/Keine

- Pfad: `D:\xiaohongshu_data\{name}_final.mp4`

### Informationsveröffentlichung

- Titel: {title}

- Tags: {tags}

- Status: {Erfolg/Fehler}

```

---

## Wichtige Regeln

1. **Priorität für natives Audio** — Seedance 2.0 unterstützt die Audiogenerierung nativ; geben Sie einfach die Sprachausgabe in der Eingabeaufforderung an.

2. **Native Untertitel** — Geben Sie den Untertitelinhalt in der Eingabeaufforderung an, und Seedance generiert automatisch synchronisierte Untertitel.

3. **Fortsetzung des letzten Bildes** — Jedes Segment verwendet das letzte Bild des vorherigen Segments als Startbild, was zu einem kohärenteren visuellen Ablauf führt.

4. **Storyboard-Aufnahmen sollten auf Englisch sein** — Seedance verwendet englische Aufnahmen für eine bessere visuelle Qualität.

5. **Einheitlicher Tonstil** — Im gesamten Film wird derselbe Tonstil verwendet.

6. **Video-Seitenverhältnis 9:16** — Xiaohongshu-Vertikalbildschirm

7. **Vor der Veröffentlichung ist eine Benutzerbestätigung erforderlich.** — Warten Sie, bis die Vorschau abgeschlossen ist, bevor Sie veröffentlichen.

8. **Bilddateinamen müssen auf Englisch sein** – Chinesische Zeichen führen zu Upload-Zeitüberschreitungen.

9. **Videoskript ≠ Text- und Bildnotizen** — Ein Skript wird in Umgangssprache verfasst, nicht als Artikel.

10. **Audioerhaltung beim Umschalten** – Videoübergang xfade + Audioübergang acrossfade

## Stichwortverzeichnis (Seedance 2.0-Leitfaden)

### Audio-Befehlsvorlage

```

Generieren Sie ein Video mit Sprachausgabe. Die Option `{voice_type}` gibt an: "{narration content}".

```

### Vorlage für Untertitelanweisungen

```

Am unteren Bildschirmrand erscheint ein Untertitel mit dem Inhalt „{Untertitelinhalt}“. Der Untertitel muss perfekt mit dem Audiorhythmus synchronisiert sein.

```

### Beispiel für vollständige Szenenanweisungen

```

Erstellen Sie ein Video mit Voice-over. Eine sanfte, ruhige Frauenstimme sagt: „Hast du jemals darüber nachgedacht, warum wir immer den Erwartungen anderer gerecht werden?“ Eine einsame Gestalt steht an einer Weggabelung in einem nebligen Wald. Sonnenlicht fällt durch hohe Bäume, warmes Licht der goldenen Stunde, langsame Kamerafahrt, geringe Schärfentiefe. Untertitel erscheinen am unteren Bildschirmrand: „Hast du jemals darüber nachgedacht, warum wir immer den Erwartungen anderer gerecht werden?“ Die Untertitel müssen perfekt mit dem Ton synchronisiert sein.

```

## Dateiverweise

| Datei | Zweck |

|------|------|

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | Seedance API + Native Audio/Subtitles + Concatenation (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | Beliebte Buchsuche |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | Veröffentlichte Datensätze |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | Abruf des Coverbildes (Backup) |

| `D:\xiaohongshu_data\` | Video- und Cover-Ausgabeverzeichnis |

## API-Konfiguration

| Parameter | Wert |

|------|-----|

| Videomodell | `doubao-seedance-2-0-fast-260128` |

| Stimmtyp | Sanfte und ruhige Frauenstimme (Standard) |

| Verhältnis | 9:16 |

| Segmentlänge | 5 Sekunden |

| Titelkarte | 3-Sekunden-Schwenk/Zoom + Ton stumm schalten |

| Überblendung | 0,5-Sekunden-Übergang (Video + Audio) |