---

nome: book-video-pipeline

Descrizione: "Generazione automatica di video di raccomandazione di libri Xiaohongshu v3 - Seedance 2.0: audio nativo + sottotitoli, completamente automatizzato dalla selezione del libro alla pubblicazione"

Licenza: MIT

invoca: "/book-video

---

# Generazione automatica della pipeline di video di raccomandazione del libro Xiaohongshu v3

book-video-pipeline

## Panoramica

Un processo completamente automatizzato per la generazione di video di raccomandazione di libri per Xiaohongshu, basato sull'API Seedance 2.0 di Volcano Ark.

**Miglioramenti della versione 3 (basati sulla guida ufficiale alle parole chiave):**

- **Audio nativo** — Specifica la narrazione direttamente nel prompt e Seedance genererà automaticamente la voce (non utilizzando più edge-tts).

- **Sottotitoli nativi** — Specifica il contenuto dei sottotitoli nel prompt e Seedance genererà sottotitoli sincronizzati all'interno del video.

- **Cartello del titolo di copertina** — Effetto Pan/Zoom + traccia audio silenziosa, per garantire la compatibilità con il montaggio.

- **Generazione a catena** — Ogni segmento utilizza l'ultimo fotogramma del segmento precedente come immagine iniziale, ottenendo così un flusso visivo più coerente.

- **Dissolvenza incrociata** — Dissolvenza incrociata video + dissolvenza incrociata audio, per transizioni audiovisive sincronizzate.

**Processo principale:** Selezione del libro → Dettagli/Copertina → Sceneggiatura → Storyboard → Generazione video (inclusi audio e sottotitoli) → Montaggio → Anteprima → Pubblicazione

---

## Protocollo di esecuzione silenziosa

Non chiedere conferma per procedere.

Genera l'output completo in un'unica operazione.

Se mancano dei dati, utilizzare i valori predefiniti.

- Non usare mai frasi di interruzione come "Vuoi continuare?", "Hai bisogno del mio aiuto?" o "Conferma".

---

## Requisiti ambientali

| Dipendenze | Installazione |

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

| Chiave API di Volcano Ark | Variabile d'ambiente `VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg` (incluso con ffmpeg) |

| Docker (xiaohongshu-mcp) | Richiede l'installazione su `localhost:18060` |

---

## Processo di esecuzione

**Metodo di attivazione: `/book-video` o `/book-video 《titolo del libro》`**

Fase 1: Selezione dei libri

**Scenario A - L'utente ha specificato il titolo di un libro:** Utilizzalo direttamente.

**Scenario B - Nessun titolo del libro specificato:** Eseguire lo script di ricerca (dando priorità ai bestseller a basso volume):

bash

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

```

Seleziona automaticamente il primo classificato nella categoria "Bestseller a bassa efficacia" (esclusi i titoli "[Pubblicati]").

**Gestione degli errori:** Timeout dello script → Cache → Ricerca Web → Predefinito (Il coraggio di non piacere)

---

Passaggio 2: ottenere i dettagli del libro e la copertina

**2.1 Ottenere i dettagli da Douban**

```

WebFetch: https://search.douban.com/book/subject_search?search_text={titolo del libro}

Estratto: Titolo del libro, autore, valutazione Douban, sinossi, citazioni chiave/punti di vista principali, URL della copertina

```

**2.2 Scarica la copertina (nome del file in inglese!)**

bash

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

```

Se curl non funziona, usa:

bash

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

```

---

Passaggio 3: Genera la sceneggiatura e lo storyboard per la raccomandazione del libro

Crea una sceneggiatura per un video in formato conversazione basandoti sui dettagli del libro.

**Formula per la riduzione delle callergia (basata sulla Guida Ufficiale Seedance 2.0):**

Ogni spunto per lo storyboard è composto da tre parti:

1. **Comandi audio** — Genera un video con voce fuori campo. Un `{voice_type}` direbbe: "testo narrazione".

2. **Descrizione visiva** — `Soggetto + Azione + Ambiente + Movimento di macchina + Atmosfera`

3. **Istruzioni per i sottotitoli** — I sottotitoli appaiono nella parte inferiore dello schermo. I sottotitoli sono "testo narrativo" e devono essere perfettamente sincronizzati con il ritmo dell'audio.

**Schema di sceneggiatura (6-7 scene, ~35 secondi):**

```markdown

## Trascrizione del video di raccomandazione del libro

**Titolo del libro**: 《{Titolo del libro}》

**Stile:** Curativo (Tonalità oro calde)

### Scena 1 - Suspense iniziale (5 secondi)

**Narrazione:** {Una frase di apertura accattivante}

**Descrizione visiva:** {50-80 parole in inglese: Soggetto + Azione + Ambiente + Inquadratura + Atmosfera}

### Scena 2 - Appaiono i libri (5 secondi)

**Narratore:** {Una breve introduzione a questo libro}

**Immagini:** {In italiano, una scena tratta da un libro}

### Storyboard 3 - Autore/Sfondo (5 secondi)

**Narrazione:** {Storia dell'autore o del suo processo creativo}

**Contesto**: {Inglese, ambiente di scrittura, studio, ecc.}

### Storyboard 4 - Punto di vista principale 1 (5 secondi)

**Narrazione:** {Un punto di vista toccante o una citazione memorabile}

**Elementi visivi:** {In inglese, metafore visive che corrispondono al punto di vista}

### Scena 5 - Punto di vista principale 2 (5 secondi)

**Narrazione:** {Un altro punto di vista avvincente o una citazione memorabile}

**Elementi visivi:** {In inglese, metafore visive che corrispondono al punto di vista}

### Storyboard 6 - Riflessioni personali (5 secondi)

**Narratore**: {I miei veri sentimenti, i cambiamenti che ho sperimentato dopo averlo letto}

**Immagini:** {Inglese, scena emozionante}

### Scena 7 - Invito all'azione (5 secondi)

**Narratore:** {Invito all'azione}

**Contenuti visivi:** {Inglese, una scena finale commovente}

```

**Regole per la descrizione dello schermo:**

- **Deve essere in inglese**, da 50 a 80 parole

- Secondo la formula: Soggetto + Quale azione viene eseguita + In quale ambiente si svolge + Qual è l'illuminazione/atmosfera + Come si muove la telecamera?

- **Non menzionare l'immagine di copertina/il titolo del libro** (testo generato dai sottotitoli)

- Descrivi scenari specifici nel modo più dettagliato possibile ed evita concetti astratti.

**Tipi di suono opzionali:**

- Guarigione: `Voce femminile dolce e calma`

- Suspense/Mistero: `Voce maschile profonda e bassa`

- Stile fresco e pulito: una voce femminile leggera e vivace.

---

Passaggio 4: Utilizzare la pipeline per generare il video.

**4.1 Salvataggio dello Storyboard in formato JSON**

json

[

{"scene_id": 1, "prompt": "Descrizione visiva in inglese...", "narrazione": "Narrazione in cinese"},

{"scene_id": 2, "prompt": "Descrizione visiva in inglese...", "narrazione": "Narrazione in cinese"},

...

]

```

Salva in `D:\xiaohongshu_data\storyboard_{english_name}.json`.

**4.2 Chiamata della pipeline completa v3**

Pitone

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")

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

storyboard = json.load(f)

risultato = client.genera_video_completo(

storyboard = storyboard,

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

book_title="Titolo del libro",

output_dir=r"D:\xiaohongshu_data",

tipo_voce="voce femminile dolce e calma",

con_sottotitoli=Vero,

)

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

```

**La pipeline v3 viene eseguita automaticamente:**

1. Copertina → Cartello del titolo (panoramica/zoom di 3 secondi + audio disattivato)

2. Genera clip video in sequenza (ogni clip include audio nativo e sottotitoli).

3. Fusione incrociata (dissolvenza incrociata video + dissolvenza incrociata audio)

4. Pubblicare il video finale.

**Configurazione della chiave API:**

bash

imposta VOLCENGINE_API_KEY=ark-xxx

```

---

### Passaggio 5: Anteprima

Genera una pagina di anteprima HTML `D:\preview_video_{name}_{date}.html`, contenente:

- Lettore video

- Titolo del libro, autore, valutazione

- Versione con testo narrativo

- Stili a tema rosa su Xiaohongshu

bash

inizio "" "D:\preview_video_xxx.html"

```

**Attendere la conferma dell'utente.** In caso di insoddisfazione, si prega di:

- Regola il prompt dello storyboard → Rigenera

- Cambia tipo di suono → Rigenera

- Regola la descrizione visiva → Modifica solo il prompt

---

Passaggio 6: Invia a Xiaohongshu

**6.1 Verifica dello stato di accesso** → MCP `check_login_status`

**6.2 Genera il testo delle note video** (non la sceneggiatura del video!)

- Titolo ≤ 20 caratteri, prospettiva in prima persona con emozione

- 200-300 parole nel testo principale, più di 20 emoji

- 10-15 tag con #

**MCP ha rilasciato la versione 6.3**

Pitone

MCP_URL = 'http://localhost:18060'

# Inizializza → publish_content(titolo, contenuto, video, tag)

# Percorso del video utilizzando il percorso del contenitore: /app/data/xxx.mp4

```

**6.4 Il record è stato pubblicato** → Aggiungi `"type": "video"` a `published_books.json`

---

## Formato di output

```markdown

## Video di raccomandazione del libro generato con successo

**Titolo del libro**: 《{Titolo del libro}》

**Autore**: {Autore} | **Douban**: {Valutazione}

### Informazioni sul video

- Durata: ~{N} secondi (3 secondi di schermata iniziale + {M} scene x 5 secondi)

- Proporzioni: 9:16 (Verticale)

- Risoluzione: 720p

- Dimensione del file: {N} MB

- Audio: Sì/No

- Sottotitoli: Incorporati/Nessuno

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

### Comunicato stampa

- Titolo: {titolo}

- Tag: {tags}

- Stato: {Successo/Fallimento}

```

---

## Regole chiave

1. **Audio nativo preferito** — Seedance 2.0 supporta nativamente la generazione audio; è sufficiente specificare la narrazione nel prompt.

2. **Sottotitoli nativi** — Specifica il contenuto dei sottotitoli nel prompt e Seedance genererà automaticamente sottotitoli sincronizzati.

3. **Continuazione dall'ultimo fotogramma** — Ogni segmento utilizza l'ultimo fotogramma del segmento precedente come immagine iniziale, ottenendo così un flusso visivo più coerente.

4. **Le inquadrature dello storyboard devono essere in inglese** — Seedance utilizza inquadrature in inglese per una migliore qualità visiva.

5. **Tipo di suono unificato** — L'intero film utilizza lo stesso tipo di suono.

6. **Formato video 9:16** — Schermo verticale Xiaohongshu

7. **È richiesta la conferma dell'utente prima della pubblicazione** — Attendere il completamento dell'anteprima prima di pubblicare.

8. **I nomi dei file immagine devono essere in inglese** — i caratteri cinesi causeranno timeout durante il caricamento.

9. **Sceneggiatura video ≠ Note di testo e immagini** — Una sceneggiatura è scritta in un linguaggio colloquiale, non come un articolo.

10. **Passa alla conservazione dell'audio** — transizione video xfade + transizione audio acrossfade

## Riferimento alle parole chiave (Guida Seedance 2.0)

### Modello di comando audio

```

Genera un video con voce fuori campo. L'opzione `{voice_type}` indica: "{contenuto della narrazione}".

```

### Modello di istruzioni per i sottotitoli

```

Nella parte inferiore dello schermo compare un sottotitolo con il contenuto "{contenuto del sottotitolo}". Il sottotitolo deve essere perfettamente sincronizzato con il ritmo dell'audio.

```

### Esempio di prompt di scena completi

```

Crea un video con una voce fuori campo. Una voce femminile dolce e calma dice: "Hai mai pensato al perché cerchiamo sempre di essere all'altezza delle aspettative degli altri?". Una figura solitaria si trova a un incrocio su un sentiero nebbioso in una foresta, la luce del sole filtra attraverso gli alberi alti, una calda illuminazione dorata, un lento movimento di carrello, una ridotta profondità di campo. I sottotitoli appaiono in basso sullo schermo con la scritta: "Hai mai pensato al perché cerchiamo sempre di essere all'altezza delle aspettative degli altri?". I sottotitoli devono essere perfettamente sincronizzati con l'audio.

```

## Riferimenti ai file

| File | Scopo |

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

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | API Seedance + Audio/Sottotitoli nativi + Concatenazione (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | Ricerca libri popolari |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | Record pubblicati |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | Recupero dell'immagine di copertina (backup) |

| `D:\xiaohongshu_data\` | Directory di output per video e copertine |

## Configurazione API

| Parametro | Valore |

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

| Modello video | `doubao-seedance-2-0-fast-260128` |

| Tipo di voce | Voce femminile dolce e calma (predefinita) |

Rapporto | 9:16 |

| Durata del segmento | 5 secondi |

| Cartello del titolo | Panoramica/Zoom di 3 secondi + audio disattivato |

| dissolvenza incrociata | transizione di 0,5 secondi (video + audio) |