---

nom : pipeline livre-vidéo

Description : « Xiaohongshu Book Recommendation Video Auto-Generation v3 - Seedance 2.0 : Audio natif + Sous-titres, entièrement automatisé de la sélection du livre à la publication »

Licence : MIT

invoquer : "/book-video

---

# Génération automatique de pipeline vidéo de recommandation de livres Xiaohongshu v3

book-video-pipeline

## Aperçu

Un processus entièrement automatisé pour générer des vidéos de recommandations de livres pour Xiaohongshu, basé sur l'API Seedance 2.0 de Volcano Ark.

**Améliorations de la v3 (basées sur le guide officiel des mots-clés) :**

- **Audio natif** — Spécifiez la narration directement dans l'invite, et Seedance générera automatiquement la voix (n'utilise plus edge-tts).

- **Sous-titres natifs** — Spécifiez le contenu des sous-titres dans l'invite, et Seedance générera des sous-titres synchronisés dans la vidéo.

- **Carte de titre de couverture** — Effet panoramique/zoom + piste audio silencieuse, assurant la compatibilité de montage.

- **Génération en chaîne** — Chaque segment utilise la dernière image du segment précédent comme image de départ, ce qui donne un flux visuel plus cohérent.

- **Fluidisation en fondu enchaîné** — Fondu vidéo + fondu audio, pour des transitions audiovisuelles synchronisées.

**Processus principal :** Sélection du livre → Détails/Couverture → Scénario → Storyboard → Création vidéo (audio et sous-titres inclus) → Montage → Aperçu → Publication

---

## Protocole d'exécution silencieuse

Ne demandez pas de confirmation pour continuer.

Générer le résultat complet en une seule fois.

Si des données sont manquantes, utilisez les valeurs par défaut définies.

- N’utilisez jamais de phrases interrompantes telles que « Voulez-vous continuer ? », « Avez-vous besoin de mon aide ? » ou « Veuillez confirmer ».

---

## Exigences environnementales

| Dépendances | Installation |

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

| Clé API Volcano Ark | Variable d'environnement `VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg` (fourni avec ffmpeg) |

| Docker (xiaohongshu-mcp) | Nécessite un déploiement sur `localhost:18060` |

---

## Processus d'exécution

**Méthode de déclenchement : `/book-video` ou `/book-video 《titre du livre》`**

Étape 1 : Sélection des livres

**Scénario A - L'utilisateur a spécifié un titre de livre :** Utilisez-le directement.

**Scénario B - Aucun titre de livre spécifié :** Exécutez le script de recherche (en privilégiant les best-sellers à faible volume) :

frapper

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

```

Sélectionner automatiquement le Top 1 de la catégorie « Meilleure vente de poudre faible » (à l'exclusion de « [Publié] »).

**Gestion des erreurs :** Délai d’expiration du script → Cache → Recherche Web → Par défaut (Le courage d’être impopulaire)

---

Étape 2 : Obtenir les détails et la couverture du livre

**2.1 Obtenir des informations auprès de Douban**

```

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

Extrait : Titre du livre, auteur, note Douban, résumé, citations clés/points de vue principaux, URL de la couverture

```

**2.2 Téléchargez la couverture (nom de fichier en anglais !)**

frapper

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

```

Si curl échoue, utilisez :

frapper

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

```

---

Étape 3 : Générer le script et le storyboard de la recommandation de livres

Générez un script vidéo conversationnel à partir des informations contenues dans le livre.

**Formule contre les allergies (basée sur le guide officiel Seedance 2.0) :**

Chaque consigne de storyboard se compose de trois parties :

1. **Commandes audio** — Génère une vidéo avec voix off. Une commande `{voice_type}` dirait : « texte de narration ».

2. **Description visuelle** — `Sujet + Action + Environnement + Mouvement de caméra + Ambiance`

3. **Instructions relatives aux sous-titres** — Les sous-titres apparaissent en bas de l'écran. Il s'agit de « texte de narration » qui doit être parfaitement synchronisé avec le rythme audio.

**Modèle de scénario (6 à 7 scènes, environ 35 secondes) :**

```markdown

## Script vidéo de recommandation de livres

**Titre du livre** : 《{Titre du livre}》

**Style :** Apaisant (tons dorés chauds)

### Scène 1 - Suspense d'ouverture (5 secondes)

**Narration :** {Une phrase d'ouverture accrocheuse}

**Description visuelle :** {50-80 mots en anglais : Sujet + Action + Environnement + Plan de caméra + Ambiance}

### Scène 2 - Apparition des livres (5 secondes)

**Narrateur :** {Une brève introduction à ce livre}

**Visuels :** {En anglais, une scène liée aux livres}

### Storyboard 3 - Auteur/Contexte (5 secondes)

**Narration :** {Contexte ou récit créatif de l'auteur}

**Scène** : {Anglais, cadre d'écriture, bureau, etc.}

### Storyboard 4 - Point de vue principal 1 (5 secondes)

**Narration :** {Un point de vue touchant ou une citation mémorable}

**Éléments visuels :** {En anglais, métaphores visuelles correspondant au point de vue}

### Scène 5 - Point de vue principal 2 (5 secondes)

**Narration :** {Un autre point de vue convaincant ou une citation mémorable}

**Éléments visuels :** {En anglais, métaphores visuelles correspondant au point de vue}

### Storyboard 6 - Réflexions personnelles (5 secondes)

**Narrateur** : {Mes véritables sentiments, les changements que j'ai ressentis après l'avoir lu}

**Visuels :** {Anglais, scène émotionnelle}

### Scène 7 - Appel à l'action (5 secondes)

**Narrateur :** {Appel à l'action}

**Visuels :** {Anglais, une scène finale touchante}

```

**Règles de description de l'écran :**

- **Doit être en anglais**, 50 à 80 mots

- Selon la formule : Sujet + Action en cours + Environnement + Éclairage/atmosphère + Mouvement de la caméra ?

- **Ne mentionnez pas l'image de couverture/le titre du livre** (texte généré à partir des sous-titres)

- Décrivez autant que possible des scénarios précis et évitez les concepts abstraits.

**Types de sons optionnels :**

- Guérison : « Voix féminine douce et calme »

- Suspense/Mystère : `Voix masculine grave et profonde`

- Un style frais et épuré : une voix féminine légère et vive.

---

Étape 4 : Utiliser le pipeline pour générer la vidéo.

**4.1 Enregistrement du storyboard au format JSON**

json

[

{"scene_id": 1, "prompt": "Description visuelle en anglais...", "narration": "Narration chinoise"},

{"scene_id": 2, "prompt": "Description visuelle en anglais...", "narration": "Narration chinoise"},

...

]

```

Enregistrer sous `D:\xiaohongshu_data\storyboard_{english_name}.json`.

**4.2 Appel du pipeline complet v3**

Python

importer sys, json

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

from seedance_client import SeedanceClient

client = SeedanceClient(api_key="VOTRE_CLÉ_API")

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

storyboard = json.load(f)

résultat = client.générer_vidéo_complète(

storyboard = storyboard,

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

book_title="Titre du livre",

output_dir=r"D:\xiaohongshu_data",

type_voix="voix féminine douce et calme",

avec_sous-titres=Vrai,

)

print(f"Vidéo : {result['video_path']} ({result['size_kb']} Ko, ~{result['duration']} s, audio : {result['has_audio']})")

```

**Le pipeline v3 s'exécute automatiquement :**

1. Couverture → Carte de titre (panoramique/zoom de 3 secondes + piste audio muette)

2. Générer des clips vidéo séquentiellement (chaque clip comprend l'audio natif et les sous-titres).

3. Assemblage par fondu enchaîné (fondu vidéo + fondu audio)

4. Exporter la vidéo finale.

**Configuration de la clé API :**

frapper

définir VOLCENGINE_API_KEY=ark-xxx

```

---

### Étape 5 : Aperçu

Générez une page d'aperçu HTML `D:\preview_video_{name}_{date}.html`, contenant :

- Lecteur vidéo

- Titre du livre, auteur, note

- Version avec texte narratif

- Styles à dominante rose sur Xiaohongshu

frapper

début "" "D:\preview_video_xxx.html"

```

**Veuillez confirmer avec l'utilisateur.** En cas d'insatisfaction, veuillez :

- Ajuster l'invite du storyboard → Régénérer

- Changer le type de son → Régénérer

- Ajuster la description visuelle → Modifier uniquement l'invite

---

Étape 6 : Publier sur Xiaohongshu

**6.1 Vérifier l'état de la connexion** → MCP `check_login_status`

**6.2 Générer le texte des notes vidéo** (Pas le script vidéo !)

Titre de 20 caractères maximum, récit à la première personne avec émotion

- 200 à 300 mots dans le texte principal, plus de 20 émojis

- 10 à 15 étiquettes avec #

**MCP publié en version 6.3**

Python

URL_MCP = 'http://localhost:18060'

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

# Chemin d'accès à la vidéo utilisant le chemin du conteneur : /app/data/xxx.mp4

```

**6.4 Enregistrement publié** → Ajoutez `"type": "video"` à `published_books.json`

---

## Format de sortie

```markdown

## Vidéo de recommandation de livre générée avec succès

**Titre du livre** : 《{Titre du livre}》

**Auteur** : {Auteur} | **Douban** : {Évaluation}

### Informations vidéo

- Durée : ~{N} secondes (carte titre de 3 s + {M} scènes x 5 s)

- Format d'image : 9:16 (Portrait)

- Résolution : 720p

- Taille du fichier : {N} Mo

- Audio : Oui/Non

- Sous-titres : Intégrés/Aucun

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

### Communiqué de presse

- Titre : {title}

- Étiquettes : {étiquettes}

- Statut : {Succès/Échec}

```

---

## Règles clés

1. **Priorité audio native** — Seedance 2.0 prend en charge nativement la génération audio ; il suffit de spécifier la narration dans l'invite.

2. **Sous-titres natifs** — Spécifiez le contenu des sous-titres dans l'invite, et Seedance générera automatiquement des sous-titres synchronisés.

3. **Continuation de la dernière image** — Chaque segment utilise la dernière image du segment précédent comme image de départ, ce qui donne un flux visuel plus cohérent.

4. **Les storyboards doivent être en anglais** — Seedance utilise des storyboards en anglais pour une meilleure qualité visuelle.

5. **Type sonore unifié** — L'ensemble du film utilise le même type sonore.

6. **Format d'image vidéo 9:16** — Écran vertical Xiaohongshu

7. **Une confirmation de l'utilisateur est requise avant la publication** — Veuillez attendre la fin de l'aperçu avant de publier.

8. **Les noms de fichiers image doivent être en anglais** — Les caractères chinois entraîneront des délais d'attente lors du téléchargement.

9. **Script vidéo ≠ Notes textuelles et visuelles** — Un script est écrit dans un langage conversationnel, et non comme un article.

10. **Préservation audio par commutation** — Transition vidéo en fondu enchaîné + transition audio en fondu enchaîné

## Référence des mots-clés (Guide Seedance 2.0)

### Modèle de commande audio

```

Générez une vidéo avec voix off. L'option `{voice_type}` indique : « {contenu de la narration} ».

```

### Modèle d'instructions pour les sous-titres

```

Un sous-titre apparaît en bas de l'écran, avec le contenu « {subtitle content} ». Ce sous-titre doit être parfaitement synchronisé avec le rythme audio.

```

### Exemple de scénario complet

```

Créez une vidéo avec une voix off. Une voix féminine douce et calme demande : « Avez-vous déjà réfléchi à la raison pour laquelle nous nous efforçons toujours de répondre aux attentes des autres ? » Une silhouette solitaire se tient à un carrefour, sur un sentier forestier brumeux. La lumière du soleil filtre à travers les grands arbres, baignée d'une douce lumière dorée. Le travelling avant est lent, avec une faible profondeur de champ. Des sous-titres apparaissent en bas de l'écran : « Avez-vous déjà réfléchi à la raison pour laquelle nous nous efforçons toujours de répondre aux attentes des autres ? » Les sous-titres doivent être parfaitement synchronisés avec l'audio.

```

## Références de fichiers

| Fichier | Objectif |

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

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | API Seedance + Audio/Sous-titres natifs + Concaténation (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | Recherche de livres populaires |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | Enregistrements publiés |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | Récupération de l'image de couverture (sauvegarde) |

| `D:\xiaohongshu_data\` | Répertoire de sortie vidéo et de couverture |

## Configuration de l'API

| Paramètre | Valeur |

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

| Modèle vidéo | `doubao-seedance-2-0-fast-260128` |

| Type de voix | Voix féminine douce et calme (par défaut) |

| Ratio | `9:16` |

| Durée du segment | 5 secondes |

| Carte de titre | Panoramique/Zoom de 3 secondes + Coupure du son |

| fondu enchaîné | transition de 0,5 seconde (vidéo + audio) |