---

назва: book-video-pipeline

Опис: «Автоматична генерація відео з рекомендаціями книг Xiaohongshu v3 - Seedance 2.0: рідний звук + субтитри, повністю автоматизовано від вибору книги до публікації»

Ліцензія: MIT

викликати: "/книга-відео

---

# Рекомендація до книги Сяохуншу Відео Автоматична генерація конвеєрів v3

конвеєр-відео-книги

## Огляд

Повністю автоматизований процес створення відео з рекомендаціями книг для Xiaohongshu на основі Seedance 2.0 API Volcano Ark.

**Покращення версії 3 (на основі офіційного посібника зі слів підказок):**

- **Рідне аудіо** — Вкажіть озвучування безпосередньо в командному рядку, і Seedance автоматично згенерує голос (більше не використовуючи edge-tts).

- **Рідні субтитри** — Вкажіть вміст субтитрів у запиті, і Seedance згенерує синхронізовані субтитри у відео.

- **Титульна картка обкладинки** — ефект панорамування/масштабування + беззвучна аудіодоріжка, що забезпечує сумісність сплайсингу.

- **Генерація ланцюга** — Кожен сегмент використовує останній кадр попереднього сегмента як початкове зображення, що призводить до більш цілісного візуального потоку.

- **Кросфейд-сплайсинг** — плавне перетворення відео та аудіо для синхронізованих аудіовізуальних переходів.

**Основний процес:** Вибір книги → Деталі/Обкладинка → Сценарій → Розкадровка → Створення відео (включно зі звуком та субтитрами) → Зшивання → Попередній перегляд → Публікація

---

## Протокол тихого виконання

Не просіть підтвердження для продовження.

Згенеруйте повний вивід за один раз.

Якщо дані відсутні, використовуйте визначені значення за замовчуванням.

– Ніколи не використовуйте переривчасті фрази, такі як «Ви хочете продовжити?», «Вам потрібна моя допомога?» або «Будь ласка, підтвердіть».

---

## Вимоги до навколишнього середовища

| Залежності | Встановлення |

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

| Ключ API Volcano Ark | Змінна середовища `VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg` (постачається з ffmpeg) |

| Docker (xiaohongshu-mcp) | Потрібне розгортання на `localhost:18060` |

---

## Процес виконання

**Метод запуску: `/book-video` або `/book-video 《назва книги》`**

Крок 1: Вибір книг

**Сценарій A – Користувач вказав назву книги:** Використайте її безпосередньо.

**Сценарій B – Назва книги не вказана:** Запустіть пошуковий скрипт (пріоритет для малотиражних бестселерів):

товчу

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

```

Автоматично вибрати Топ 1 з категорії «Бестселер із низьким вмістом порошку» (за винятком «[Опубліковано]»).

**Обробка помилок:** Час очікування скрипта → Кеш → Веб-пошук → За замовчуванням (Сміливість бути недолюбленим)

---

Крок 2: Отримайте інформацію про книгу та обкладинку

**2.1 Отримайте детальну інформацію від Дубана**

```

WebFetch: https://search.douban.com/book/subject_search?search_text={назва книги}

Витяг: Назва книги, автор, рейтинг Дубана, синопсис, ключові цитати/основні точки зору, URL-адреса обкладинки

```

**2.2 Завантажте обкладинку (назва файлу англійською!)**

товчу

curl -o "D:\xiaohongshu_data\cover_{english_name}.jpg" -H "Посилання: https://book.douban.com/" "URL-адреса обкладинки"

```

Якщо curl не спрацює, використовуйте:

товчу

python "D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py" "{назва книги}"

```

---

Крок 3: Створіть сценарій рекомендації книги + розкадровку

Створіть сценарій розмовного відео на основі деталей книги.

**Формула калорій (на основі офіційного посібника Seedance 2.0):**

Кожна підказка для розкадровки складається з трьох частин:

1. **Аудіокоманди** — Генерує відео з озвучуванням. `{voice_type}` буде мати вигляд: «текст озвучування».

2. **Візуальний опис** — `Об'єкт + Дія + Навколишнє середовище + Рух камери + Атмосфера`

3. **Інструкції щодо субтитрів** — Субтитри відображаються внизу екрана. Субтитри є «текстом озвучування» та мають бути ідеально синхронізовані з аудіоритмом.

**Шаблон сценарію (6-7 сцен, ~35 секунд):**

«уцінка»

## Сценарій відео з рекомендацією книги

**Назва книги**: 《{Назва книги}》

**Стиль:** Зцілення (теплі золотисті тони)

### Сцена 1 – Вступний саспенс (5 секунд)

**Оповідь:** {Приваблива вступна фраза}

**Візуальний опис:** {50-80 слів англійською мовою: Тема + Дія + Навколишнє середовище + Знімок камери + Атмосфера}

### Сцена 2 – З’являються книги (5 секунд)

**Оповідач:** {Короткий вступ до цієї книги}

**Візуальні матеріали:** {Англійською мовою, сцена, пов’язана з книгою}

### Розкадровка 3 – Автор/Передумови (5 секунд)

**Оповідь:** {Історія автора або творча історія}

**Сцена**: {Англійська мова, обстановка для письма, навчання тощо}

### Розкадровка 4 – Основна точка зору 1 (5 секунд)

**Оповідь:** {Зворушлива точка зору або цитата, що запам'ятовується}

**Візуальні матеріали:** {Англійською мовою, візуальні метафори, що відповідають точці зору}

### Сцена 5 – Основна точка зору 2 (5 секунд)

**Оповідь:** {Ще одна захоплива точка зору або цитата, що запам'ятовується}

**Візуальні матеріали:** {Англійською мовою, візуальні метафори, що відповідають точці зору}

### Розкадровка 6 – Особисті роздуми (5 секунд)

**Оповідач**: {Мої справжні почуття, зміни, які я відчув після прочитання}

**Візуальні матеріали:** {англійська, емоційна сцена}

### Сцена 7 – Заклик до дії (5 секунд)

**Оповідач:** {Заклик до дії}

**Візуальні матеріали:** {Англійська, зворушлива фінальна сцена}

```

**Правила опису екрана**:

- **Має бути англійською мовою**, 50-80 слів

- За формулою: Об'єкт + Яка дія виконується + У якому середовищі він знаходиться + У якому освітленні/атмосфері він знаходиться + Як рухається камера?

- **Не згадуйте зображення обкладинки/текст назви книги** (текст згенеровано з субтитрів)

- Опишіть конкретні сценарії якомога детальніше та уникайте абстрактних понять.

**Додаткові типи звуків:**

- Зцілення: «Ніжний та спокійний жіночий голос»

- Саспенс/Таємниця: «Глибокий, низький чоловічий голос»

- Свіжий та чистий стиль: легкий та жвавий жіночий голос.

---

Крок 4: Використайте конвеєр для створення відео.

**4.1 Збереження JSON-файлу розкадровки**

json

[

{"scene_id": 1, "prompt": "Візуальний опис англійською...", "narration": "Озвучування китайською"},

{"scene_id": 2, "prompt": "Візуальний опис англійською...", "narration": "Озвучування китайською"},

...

]

```

Зберегти в `D:\xiaohongshu_data\storyboard_{english_name}.json`.

**4.2 Виклик повного конвеєра версії 3**

Пітон

імпортувати sys, json

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

з імпорту Seedance_client з seedance_client

клієнт = SeedanceClient(api_key="ВАШ_КЛЮЧ_API")

з відкритим(r"D:\xiaohongshu_data\storyboard_xxx.json", кодування="utf-8") як f:

розкадровка = json.load(f)

результат = клієнт.generate_full_video(

розкадровка = розкадровка,

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

book_title="Назва книги",

output_dir=r"D:\xiaohongshu_data",

voice_type="ніжний та спокійний жіночий голос",

with_subtitles=Правда,

)

print(f"Відео: {result['video_path']} ({result['size_kb']}КБ, ~{result['duration']}с, аудіо: {result['has_audio']})")

```

**конвеєр версії 3 виконується автоматично:**

1. Обкладинка → Заголовок (3-секундне панорамування/масштабування + вимкнення аудіодоріжки)

2. Послідовно генеруйте відеокліпи (кожен кліп містить власний звук та субтитри).

3. Зшивання крос-фейдів (перехід відео + перехід аудіо)

4. Виведіть кінцевий відеозапис.

**Конфігурація ключа API:**

товчу

встановити VOLCENGINE_API_KEY=ark-xxx

```

---

### Крок 5: Попередній перегляд

Згенеруйте сторінку попереднього перегляду HTML `D:\preview_video_{name}_{date}.html`, що містить:

- Відеоплеєр

- Назва книги, автор, рейтинг

- Версія з текстом оповідання

- Рожеві стилі на Xiaohongshu

товчу

початок "" "D:\preview_video_xxx.html"

```

**Будь ласка, зачекайте підтвердження користувача.** Якщо ви незадоволені, будь ласка:

- Налаштуйте підказку розкадровки → Згенерувати знову

- Змінити тип звуку → Регенерувати

- Налаштуйте візуальний опис → Змініть лише підказку

---

Крок 6: Опублікувати в Xiaohongshu

**6.1 Перевірка статусу входу** → MCP `check_login_status`

**6.2 Генерація тексту відеонотаток** (не відеосценарію!)

- Назва ≤ 20 символів, від першої особи з емоціями

- 200-300 слів в основному тексті, 20+ емодзі

- 10-15 тегів з #

**Випущено MCP версії 6.3**

Пітон

MCP_URL = 'http://localhost:18060'

# Ініціалізація → publish_content(заголовок, контент, відео, теги)

# Шлях до відео з використанням шляху контейнера: /app/data/xxx.mp4

```

**6.4 Запис опубліковано** → Додати `"type": "video"` до `published_books.json`

---

## Формат виводу

«уцінка»

## Відео з рекомендацією книги успішно згенеровано

**Назва книги**: 《{Назва книги}》

**Автор**: {Автор} | **Дубан**: {Рейтинг}

### Інформація про відео

- Тривалість: ~{N} секунд (3 с титульна картка + {M} сцени x 5 с)

- Співвідношення сторін: 9:16 (портрет)

- Роздільна здатність: 720p

- Розмір файлу: {N} МБ

- Аудіо: Так/Ні

- Субтитри: Вбудовані/Немає

- Шлях: `D:\xiaohongshu_data\{name}_final.mp4`

### Інформаційний випуск

- Назва: {назва}

- Теги: {tags}

- Статус: {Успіх/Невдача}

```

---

## Ключові правила

1. **Перевага надано власному аудіо** — Seedance 2.0 має вбудовану підтримку генерації аудіо; просто вкажіть текст озвучування в командному рядку.

2. **Рідні субтитри** — Вкажіть вміст субтитрів у запиті, і Seedance автоматично згенерує синхронізовані субтитри.

3. **Продовження останнього кадру** — Кожен сегмент використовує останній кадр попереднього сегмента як початкове зображення, що призводить до більш цілісного візуального потоку.

4. **Знімки розкадровки мають бути англійською мовою** — Seedance використовує знімки англійською мовою для кращої візуальної якості.

5. **Єдиний тип звуку** — У всьому фільмі використовується один і той самий тип звуку.

6. **Співвідношення сторін відео 9:16** — вертикальний екран Xiaohongshu

7. **Перед публікацією потрібне підтвердження користувача** — Зачекайте завершення попереднього перегляду, перш ніж публікувати.

8. **Назви файлів зображень мають бути англійською мовою** — використання китайських ієрогліфів призведе до затримки завантаження.

9. **Відеосценарій ≠ Текстові та графічні нотатки** — Сценарій пишеться розмовною мовою, а не як стаття.

10. **Збереження звуку перемикача** — відеоперехід xfade + аудіоперехід acrossfade

## Довідник ключових слів (Посібник Seedance 2.0)

### Шаблон аудіокоманди

```

Згенеруйте відео з озвучуванням. Параметр `{voice_type}` говорить: "{narration content}".

```

### Шаблон інструкції з субтитрів

```

Внизу екрана з’являється субтитр із вмістом «{subtitle content}». Субтитри мають бути ідеально синхронізовані з аудіоритмом.

```

### Приклад повних підказок для сцени

```

Зробіть відео з закадровим голосом. Ніжний, спокійний жіночий голос каже: «Ви коли-небудь замислювалися про те, чому ми завжди виправдовуємо очікування інших людей?» Самотня постать стоїть на перехресті на туманній лісовій стежці, сонячне світло просочується крізь високі дерева, тепле золоте освітлення, повільне прибуття візка, мала глибина різкості. Внизу екрана з’являються субтитри: «Ви коли-небудь замислювалися про те, чому ми завжди виправдовуємо очікування інших людей?» Субтитри мають бути ідеально синхронізовані зі звуком.

```

## Посилання на файли

| Файл | Мета |

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

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | Seedance API + Нативний звук/Субтитри + Конкатенація (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | Пошук популярних книг |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | Опубліковані записи |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | Отримання зображення обкладинки (резервна копія) |

| `D:\xiaohongshu_data\` | Каталог відео та обкладинок |

## Конфігурація API

| Параметр | Значення |

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

| Відео Модель | `doubao-seedance-2-0-fast-260128` |

| Тип голосу | Ніжний та спокійний жіночий голос (за замовчуванням) |

| Співвідношення | `9:16` |

| Тривалість сегмента | 5 секунд |

| Картка титулу | 3-секундне панорамування/масштабування + вимкнення звуку |

| кросфейд | 0,5-секундний перехід (відео + аудіо) |