---

название: book-video-pipeline

Описание: "Автоматическая генерация видеороликов с рекомендациями книг от издательства Xiaohongshu, версия 3 - Seedance 2.0: встроенное аудио + субтитры, полностью автоматизированный процесс от выбора книги до публикации"

Лицензия: MIT

вызвать: "/book-video

---

# Видео с рекомендациями книг Сяохуншу. Автоматическая генерация конвейера обработки данных, версия 3.

book-video-pipeline

## Обзор

Полностью автоматизированный процесс генерации видеороликов с рекомендациями книг для Xiaohongshu на основе API Seedance 2.0 из 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 Получите подробную информацию на Douban**

```

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

Выдержка: Название книги, автор, рейтинг Douban, аннотация, ключевые цитаты/основные точки зрения, URL обложки.

```

**2.2 Скачайте обложку (название файла на английском языке!)**

баш

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

```

Если curl не сработает, используйте:

баш

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

```

---

Шаг 3: Создание сценария и раскадровки для рекомендаций книг.

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

**Формула Callergy (на основе официального руководства Seedance 2.0):**

Каждый вариант раскадровки состоит из трех частей:

1. **Аудиокоманды** — Создает видео с озвучкой. Команда `{voice_type}` будет выглядеть так: "текстовое повествование".

2. **Визуальное описание** — «Субъект + Действие + Окружение + Движение камеры + Атмосфера»

3. **Инструкции по субтитрам** — Субтитры отображаются внизу экрана. Субтитры представляют собой «текст повествования» и должны быть идеально синхронизированы с ритмом аудиозаписи.

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

«markdown»

## Сценарий видеоролика с рекомендациями книг

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

**Стиль:** Заживляющий (теплые золотистые тона)

### Сцена 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 Вызов полного конвейера v3**

Python

импорт 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)

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

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

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

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

output_dir=r"D:\xiaohongshu_data",

voice_type="нежный и спокойный женский голос",

with_subtitles=True,

)

print(f"Видео: {result['video_path']} ({result['size_kb']}KB, ~{result['duration']}s, аудио: {result['has_audio']})")

```

**Конвейер v3 выполняется автоматически:**

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

2. Создавайте видеоклипы последовательно (каждый клип включает исходный звук и субтитры).

3. Сшивание переходов (видеозатемнение + аудиозатемнение)

4. Сгенерируйте итоговое видео.

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

баш

set VOLCENGINE_API_KEY=ark-xxx

```

---

### Шаг 5: Предварительный просмотр

Создайте HTML-страницу предварительного просмотра `D:\preview_video_{name}_{date}.html`, содержащую:

- Видеоплеер

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

- Текстовая версия с озвучкой

- На сайте Xiaohongshu представлены модели в розовых тонах.

баш

начало "" "D:\preview_video_xxx.html"

```

**Пожалуйста, дождитесь подтверждения пользователя.** Если вы не удовлетворены, пожалуйста:

- Скорректируйте подсказку раскадровки → Перегенерировать

- Изменить тип звука → Восстановить

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

---

Шаг 6: Отправьте сообщение на Сяохуншу.

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

**6.2 Создание текста для заметок к видео** (Не сценарий видео!)

- Заголовок ≤ 20 символов, повествование от первого лица с выражением эмоций.

- 200-300 слов в основном тексте, более 20 смайликов.

- 10-15 тегов с хештегом

**Выпущена версия MCP 6.3**

Python

MCP_URL = 'http://localhost:18060'

# Инициализация → publish_content(title, content, video, tags)

# Путь к видеофайлу, используя путь контейнера: /app/data/xxx.mp4

```

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

---

## Формат вывода

«markdown»

## Видео с рекомендацией книги успешно сгенерировано

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

**Автор**: {Автор} | **Douban**: {Рейтинг}

### Информация о видео

- Продолжительность: ~{N} секунд (3 секунды заставка + {M} сцен x 5 секунд)

- Соотношение сторон: 9:16 (портрет)

- Разрешение: 720p

- Размер файла: {N} МБ

- Аудио: Да/Нет

- Субтитры: Встроенные/Отсутствуют

- Путь: `D:\xiaohongshu_data\{name}_final.mp4`

### Раскрытие информации

- Заголовок: {title}

- Теги: {теги}

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

```

---

## Основные правила

1. **Предпочтительно использование встроенного аудио** — Seedance 2.0 изначально поддерживает генерацию аудио; просто укажите желаемый текст в запросе.

2. **Субтитры в исходном виде** — Укажите содержимое субтитров в подсказке, и Seedance автоматически сгенерирует синхронизированные субтитры.

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

4. **Кадры раскадровки должны быть на английском языке** — Seedance использует кадры на английском языке для лучшего визуального качества.

5. **Единый тип звука** — Весь фильм использует один и тот же тип звука.

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

7. **Перед публикацией требуется подтверждение пользователя** — Дождитесь завершения предварительного просмотра перед публикацией.

8. **Имена файлов изображений должны быть на английском языке** — китайские символы приведут к задержкам при загрузке.

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

10. **Сохранение звука при переключении** — плавный переход видео + плавный переход звука

## Справочник ключевых слов (Руководство Seedance 2.0)

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

```

Создайте видео с озвучкой. Параметр `{voice_type}` означает: "{narration content}".

```

### Шаблон инструкции по созданию субтитров

```

В нижней части экрана появляется субтитр со следующим содержимым: "{содержимое субтитров}". Субтитры должны быть идеально синхронизированы с ритмом аудиозаписи.

```

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

```

Создайте видео с закадровым голосом. Нежный, спокойный женский голос произносит: «Вы когда-нибудь задумывались, почему мы всегда оправдываем ожидания других людей?» Одинокая фигура стоит на перекрестке на туманной лесной тропе, солнечный свет пробивается сквозь высокие деревья, теплое освещение «золотого часа», медленное приближение камеры, малая глубина резкости. Внизу экрана появляются субтитлы: «Вы когда-нибудь задумывались, почему мы всегда оправдываем ожидания других людей?» Субтитлы должны быть идеально синхронизированы со звуком.

```

## Ссылки на файлы

| Файл | Назначение |

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

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | API Seedance + встроенное аудио/субтитры + конкатенация (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 секунды (видео + аудио) |