---

nombre: canalización de libros y vídeos

Descripción: "Generación automática de vídeos de recomendación de libros de Xiaohongshu v3 - Seedance 2.0: Audio nativo + subtítulos, totalmente automatizado desde la selección del libro hasta su publicación".

Licencia: MIT

invocar: "/book-video

---

# Generación automática de canalizaciones de vídeo de recomendación de libros de Xiaohongshu v3

book-video-pipeline

## Descripción general

Un proceso totalmente automatizado para generar vídeos de recomendación de libros para Xiaohongshu basado en la API Seedance 2.0 de Volcano Ark.

**Mejoras de la versión 3 (basadas en la guía oficial de palabras clave):**

- **Audio nativo** — Especifique la narración directamente en la solicitud y Seedance generará automáticamente la voz (ya no se utiliza edge-tts).

- **Subtítulos nativos** — Especifique el contenido de los subtítulos en la solicitud y Seedance generará subtítulos sincronizados dentro del video.

- **Título de portada** — Efecto de panorámica/zoom + pista de audio silenciosa, lo que garantiza la compatibilidad de empalme.

- **Generación en cadena**: cada segmento utiliza el último fotograma del segmento anterior como imagen de inicio, lo que da como resultado un flujo visual más coherente.

- **Empalme con fundido cruzado** — Fundido cruzado de vídeo + fundido cruzado de audio, para transiciones audiovisuales sincronizadas.

**Proceso principal:** Selección del libro → Detalles/Portada → Guion → Storyboard → Generación de vídeo (incluidos audio y subtítulos) → Montaje → Vista previa → Publicación

---

## Protocolo de ejecución silenciosa

No solicite confirmación para continuar.

Generar el resultado completo de una sola vez.

Si faltan datos, utilice los valores predeterminados definidos.

- Nunca utilice frases que interrumpan, como "¿Desea continuar?", "¿Necesita mi ayuda?" o "Por favor, confirme".

---

## Requisitos ambientales

| Dependencias | Instalación |

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

| Clave API de Volcano Ark | Variable de entorno `VOLCENGINE_API_KEY` |

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

| Docker (xiaohongshu-mcp) | Requiere despliegue en `localhost:18060` |

---

## Proceso de ejecución

**Método de activación: `/book-video` o `/book-video 《título del libro》`**

Paso 1: Selección de libros

**Escenario A - El usuario especificó un título de libro:** Úselo directamente.

**Escenario B - No se especificó el título del libro:** Ejecutar el script de búsqueda (priorizando los bestsellers de bajo volumen):

intento

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

```

Seleccionar automáticamente el número 1 de la categoría "Los más vendidos de baja pólvora" (excluyendo "[Publicado]").

**Gestión de errores:** Tiempo de espera del script → Caché → Búsqueda web → Predeterminado (El valor de no gustar)

---

Paso 2: Obtener los detalles del libro y la portada.

**2.1 Obtener detalles de Douban**

```

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

Extracto: Título del libro, autor, calificación de Douban, sinopsis, citas clave/puntos de vista principales, URL de la portada.

```

**2.2 Descarga la portada (¡nombre de archivo en inglés!)**

intento

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

```

Si curl falla, utilice:

intento

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

```

---

Paso 3: Generar el guion de recomendación de libros y el guion gráfico.

Genera un guion de vídeo conversacional basado en los detalles del libro.

**Fórmula de Callergy (basada en la Guía Oficial de Seedance 2.0):**

Cada indicación para el guion gráfico consta de tres partes:

1. **Comandos de audio** — Genera video con voz en off. Un `{voice_type}` diría: "texto de narración".

2. **Descripción visual** — `Sujeto + Acción + Entorno + Movimiento de cámara + Atmósfera`

3. **Instrucciones para los subtítulos** — Los subtítulos aparecen en la parte inferior de la pantalla. Son texto narrativo y deben estar perfectamente sincronizados con el ritmo del audio.

**Plantilla de guion (6-7 escenas, ~35 segundos):**

```rebaja

## Guion para vídeo de recomendación de libros

**Título del libro**: 《{Título del libro}》

**Estilo:** Sanador (Tonos dorados cálidos)

### Escena 1 - Suspenso inicial (5 segundos)

**Narración:** {Una frase inicial llamativa}

**Descripción visual:** {50-80 palabras en inglés: Tema + Acción + Entorno + Plano de cámara + Atmósfera}

### Escena 2 - Aparecen los libros (5 segundos)

**Narrador:** {Una breve introducción a este libro}

**Imágenes:** {En inglés, una escena relacionada con libros}

### Guion gráfico 3 - Autor/Fondo (5 segundos)

**Narración:** {Antecedentes del autor o historia creativa}

**Escena**: {Inglés, entorno de escritura, estudio, etc.}

### Guion gráfico 4 - Punto de vista principal 1 (5 segundos)

**Narración:** {Un punto de vista conmovedor o una cita memorable}

**Elementos visuales:** {En inglés, metáforas visuales que coinciden con el punto de vista}

### Escena 5 - Punto de vista principal 2 (5 segundos)

**Narración:** {Otro punto de vista convincente o una cita memorable}

**Elementos visuales:** {En inglés, metáforas visuales que coinciden con el punto de vista}

### Guion gráfico 6 - Reflexiones personales (5 segundos)

**Narrador**: {Mis verdaderos sentimientos, los cambios que experimenté después de leerlo}

**Imágenes:** {Inglés, escena emotiva}

### Escena 7 - Llamada a la acción (5 segundos)

**Narrador:** {Llamada a la acción}

**Imágenes:** {Inglés, una escena final conmovedora}

```

**Reglas de descripción de pantalla:**

- **Debe estar en inglés**, 50-80 palabras

- Según la fórmula: Sujeto + Qué acción se está realizando + En qué entorno se encuentra + Qué iluminación/atmósfera hay + ¿Cómo se mueve la cámara?

- **No mencione la imagen de la portada ni el título del libro** (texto generado a partir de subtítulos).

- Describa escenarios específicos en la medida de lo posible y evite los conceptos abstractos.

**Tipos de sonido opcionales:**

- Sanación: `Voz femenina suave y tranquila`

- Suspenso/Misterio: `Voz masculina grave y profunda`

- Estilo fresco y limpio: Una voz femenina ligera y vivaz.

---

Paso 4: Utilice el proceso para generar el vídeo.

**4.1 Guardar el JSON del Storyboard**

json

[

{"scene_id": 1, "prompt": "Descripción visual en inglés...", "narration": "Narración en chino"},

{"scene_id": 2, "prompt": "Descripción visual en inglés...", "narration": "Narración en chino"},

...

]

```

Guárdalo en `D:\xiaohongshu_data\storyboard_{english_name}.json`.

**4.2 Llamada a la canalización completa v3**

Pitón

importar sys, json

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

from seedance_client import SeedanceClient

cliente = SeedanceClient(api_key="TU_CLAVE_API")

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

storyboard = json.load(f)

resultado = cliente.generar_video_completo(

storyboard = storyboard,

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

book_title="Título del libro",

output_dir=r"D:\xiaohongshu_data",

tipo_de_voz="voz femenina suave y tranquila",

con_subtítulos=Verdadero,

)

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

```

**La canalización v3 se ejecuta automáticamente:**

1. Portada → Tarjeta de título (panorámica/zoom de 3 segundos + silenciar la pista de audio)

2. Generar videoclips de forma secuencial (cada clip incluye audio nativo y subtítulos).

3. Unión con fundido cruzado (fundido cruzado de vídeo + fundido cruzado de audio)

4. Generar el vídeo final.

**Configuración de la clave API:**

intento

establecer VOLCENGINE_API_KEY=ark-xxx

```

---

### Paso 5: Vista previa

Genera una página de vista previa HTML `D:\preview_video_{name}_{date}.html`, que contenga:

- Reproductor de vídeo

- Título del libro, autor, calificación

- Versión de texto con narración

- Estilos con temática rosa en Xiaohongshu

intento

inicio "" "D:\preview_video_xxx.html"

```

**Por favor, confirme con el usuario.** Si no está satisfecho, por favor:

- Ajustar la indicación del guion gráfico → Regenerar

- Cambiar tipo de sonido → Regenerar

- Ajustar la descripción visual → Solo cambiar la indicación

---

Paso 6: Enviar a Xiaohongshu

**6.1 Comprobar el estado de inicio de sesión** → MCP `check_login_status`

**6.2 Generar texto para las notas del vídeo** (¡No es el guion del vídeo!)

- Título ≤ 20 caracteres, perspectiva en primera persona con emoción

- 200-300 palabras en el texto principal, más de 20 emojis

- 10-15 etiquetas con #

**MCP lanzado 6.3**

Pitón

MCP_URL = 'http://localhost:18060'

# Inicialización → publicar_contenido(título, contenido, vídeo, etiquetas)

# Ruta del vídeo utilizando la ruta del contenedor: /app/data/xxx.mp4

```

**6.4 El registro ha sido publicado** → Agrega `"type": "video"` a `published_books.json`

---

## Formato de salida

```rebaja

## Vídeo de recomendación de libro generado correctamente

**Título del libro**: 《{Título del libro}》

**Autor**: {Autor} | **Douban**: {Calificación}

### Información del video

- Duración: ~{N} segundos (3 s de título + {M} escenas x 5 s)

- Relación de aspecto: 9:16 (Vertical)

- Resolución: 720p

- Tamaño del archivo: {N} MB

- Audio: Sí/No

- Subtítulos: Integrados/Ninguno

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

### Comunicado de información

- Título: {título}

- Etiquetas: {tags}

- Estado: {Éxito/Fracaso}

```

---

## Reglas clave

1. **Prioridad de audio nativo**: Seedance 2.0 admite de forma nativa la generación de audio; simplemente especifique la narración en la solicitud.

2. **Subtítulos nativos** — Especifique el contenido de los subtítulos en la solicitud y Seedance generará automáticamente subtítulos sincronizados.

3. **Continuación del último fotograma**: cada segmento utiliza el último fotograma del segmento anterior como imagen de inicio, lo que da como resultado un flujo visual más coherente.

4. **Los planos del storyboard deben estar en inglés** — Seedance utiliza planos en inglés para una mejor calidad visual.

5. **Tipo de sonido unificado** — Toda la película utiliza el mismo tipo de sonido.

6. **Relación de aspecto de vídeo 9:16** — Pantalla vertical Xiaohongshu

7. **Se requiere confirmación del usuario antes de la publicación** — Espere a que finalice la vista previa antes de publicar.

8. **Los nombres de archivo de las imágenes deben estar en inglés**; los caracteres chinos provocarán tiempos de espera agotados al cargarlas.

9. **Guion de vídeo ≠ Notas de texto e imagen** — Un guion está escrito en lenguaje coloquial, no como un artículo.

10. **Conservación de audio con cambio** — transición de vídeo con fundido cruzado + transición de audio con fundido transversal

## Referencia de palabras clave (Guía de Seedance 2.0)

### Plantilla de comando de audio

```

Generar un vídeo con voz en off. La opción `{voice_type}` indica: "{contenido de la narración}".

```

### Plantilla de instrucciones para subtítulos

```

Aparece un subtítulo en la parte inferior de la pantalla con el texto "{contenido del subtítulo}". El subtítulo debe estar perfectamente sincronizado con el ritmo del audio.

```

### Ejemplo de indicaciones de escena completas

```

Genera un video con voz en off. Una voz femenina suave y tranquila dice: "¿Alguna vez te has preguntado por qué siempre cumplimos con las expectativas de los demás?". Una figura solitaria se encuentra en una encrucijada en un sendero brumoso del bosque, la luz del sol se filtra entre los árboles altos, iluminación cálida del atardecer, acercamiento lento, poca profundidad de campo. Los subtítulos aparecen en la parte inferior de la pantalla y dicen: "¿Alguna vez te has preguntado por qué siempre cumplimos con las expectativas de los demás?". Los subtítulos deben estar perfectamente sincronizados con el audio.

```

## Referencias de archivos

| Archivo | Propósito |

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

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | API de Seedance + Audio/Subtítulos nativos + Concatenación (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | Búsqueda de libros populares |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | Registros publicados |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | Recuperación de la imagen de la portada (copia de seguridad) |

| `D:\xiaohongshu_data\` | Directorio de salida de vídeo y portada |

## Configuración de la API

| Parámetro | Valor |

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

| Modelo de vídeo | `doubao-seedance-2-0-fast-260128` |

| Tipo de voz | Voz femenina suave y tranquila (predeterminada) |

| Relación | `9:16` |

| Duración del segmento | 5 segundos |

| Tarjeta de título | Panorámica/Zoom de 3 segundos + Silenciar audio |

| Fundido cruzado | Transición de 0,5 segundos (vídeo + audio) |