---

isim: kitap-video-işlem hattı

Açıklama: "Xiaohongshu Kitap Önerisi Videosu Otomatik Oluşturma v3 - Seedance 2.0: Orijinal Ses + Altyazı, Kitap Seçiminden Yayınlamaya Kadar Tam Otomatik"

Lisans: MIT

çağır: "/kitap-video

---

# Xiaohongshu Kitap Önerisi Videosu Otomatik İşlem Hattı Oluşturma v3

book-video-pipeline

## Genel Bakış

Volcano Ark'ın Seedance 2.0 API'sini temel alan, Xiaohongshu için kitap öneri videoları oluşturmaya yönelik tamamen otomatikleştirilmiş bir süreç.

**v3 İyileştirmeleri (resmi komut satırı kılavuzuna göre):**

- **Yerel Seslendirme** — Anlatımı doğrudan komut isteminde belirtin ve Seedance otomatik olarak sesi oluşturacaktır (artık edge-tts kullanılmayacak).

- **Orijinal Altyazılar** — Altyazı içeriğini komut isteminde belirtin ve Seedance video içinde senkronize altyazılar oluşturacaktır.

- **Kapak Başlık Kartı** — Pan/Zoom efekti + sessiz ses parçası, birleştirme uyumluluğunu sağlar.

- **Zincirleme Görüntü Oluşturma** — Her bölüm, önceki bölümün son karesini başlangıç ​​görüntüsü olarak kullanır; bu da daha tutarlı bir görsel akış sağlar.

- **Çapraz geçiş birleştirme** — Senkronize görsel-işitsel geçişler için video çapraz geçişi + ses çapraz geçişi.

**Temel Süreç:** Kitap Seçimi → Detaylar/Kapak → Senaryo → Hikaye Panosu → Video Oluşturma (ses ve altyazı dahil) → Birleştirme → Önizleme → Yayınlama

---

## Sessiz Yürütme Protokolü

Devam etmek için onay istemeyin.

Tüm çıktıyı tek seferde oluşturun.

Veriler eksikse, tanımlanmış varsayılan değerleri kullanın.

- "Devam etmek ister misiniz?", "Yardıma ihtiyacınız var mı?" veya "Lütfen onaylayın" gibi sözünüzü kesen ifadelerden asla yararlanmayın.

---

## Çevresel Gereksinimler

| Bağımlılıklar | Kurulum |

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

| Volcano Ark API Anahtarı | Ortam değişkeni `VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg` (ffmpeg ile birlikte gelir) |

| Docker (xiaohongshu-mcp) | `localhost:18060` adresine dağıtım gerektirir |

---

## Yürütme Süreci

**Tetikleme yöntemi: `/book-video` veya `/book-video 《kitap başlığı》`**

Adım 1: Kitap Seçimi

**Senaryo A - Kullanıcı bir kitap başlığı belirtti:** Doğrudan kullanın.

**Senaryo B - Kitap başlığı belirtilmemiş:** Arama komutunu çalıştırın (düşük satış rakamlı çok satanlara öncelik vererek):

vurmak

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

```

"Düşük Tozlu En Çok Satanlar" kategorisinden ( "[Yayınlanmış]" hariç) ilk 1'i otomatik olarak seçin.

**Hata Yönetimi:** Komut Dosyası Zaman Aşımı → Önbellek → Web Araması → Varsayılan (Beğenilmemeye Cesaret Etmek)

---

Adım 2: Kitabın detaylarını ve kapağını edinin.

**2.1 Douban'dan detayları edinin**

```

WebFetch: https://search.douban.com/book/subject_search?search_text={kitap başlığı}

Özet: Kitap adı, yazar, Douban puanı, özet, önemli alıntılar/temel görüşler, kapak URL'si

```

**2.2 Kapak resmini indirin (İngilizce dosya adı!)**

vurmak

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

```

Curl işlemi başarısız olursa şunu kullanın:

vurmak

python "D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py" "{kitap başlığı}"

```

---

3. Adım: Kitap Önerisi Senaryosu ve Hikaye Panosu Oluşturma

Kitaptaki detaylara dayanarak diyalog tarzında bir video senaryosu oluşturun.

**Alarji Formülü (Seedance 2.0 Resmi Kılavuzuna göre):**

Her bir storyboard konusu üç bölümden oluşur:

1. **Sesli Komutlar** — Seslendirmeli video oluşturur. `{voice_type}` komutu "anlatım metni" anlamına gelir.

2. **Görsel Açıklama** — `Konu + Eylem + Ortam + Kamera Hareketi + Atmosfer`

3. **Altyazı Talimatları** — Altyazılar ekranın alt kısmında görünür. Altyazılar "anlatım metni"dir ve ses ritmiyle mükemmel bir şekilde senkronize edilmelidir.

**Senaryo Şablonu (6-7 sahne, ~35 saniye):**

```markdown

## Kitap Önerisi Videosu Senaryosu

**Kitap Adı**: 《{Kitap Adı}》

**Tarz:** Şifa (Sıcak Altın Tonları)

### Sahne 1 - Açılış Gerilimi (5 saniye)

**Anlatım:** {Dikkat çekici bir açılış cümlesi}

**Görsel Açıklama:** {50-80 kelime İngilizce: Konu + Eylem + Ortam + Kamera Açısı + Atmosfer}

### Sahne 2 - Kitaplar Görünüyor (5 saniye)

**Anlatıcı:** {Bu kitaba kısa bir giriş}

**Görseller:** {İngilizce olarak, bir kitapla ilgili bir sahne}

### Hikaye Panosu 3 - Yazar/Arka Plan (5 saniye)

**Anlatım:** {Yazarın özgeçmişi veya yaratıcı öyküsü}

**Ortam**: {İngilizce, yazma ortamı, çalışma, vb.}

### Hikaye Panosu 4 - Temel Bakış Açısı 1 (5 saniye)

**Anlatım:** {Dokunaklı bir bakış açısı veya unutulmaz bir alıntı}

**Görseller:** {Bakış açısıyla uyumlu görsel metaforlar}

### Sahne 5 - Temel Bakış Açısı 2 (5 saniye)

**Anlatım:** {Başka bir ilgi çekici bakış açısı veya akılda kalıcı alıntı}

**Görseller:** {Bakış açısıyla uyumlu görsel metaforlar}

### Hikaye Panosu 6 - Kişisel Düşünceler (5 saniye)

**Anlatıcı**: {Gerçek duygularım, kitabı okuduktan sonra yaşadığım değişimler}

**Görseller:** {İngilizce, duygusal sahne}

### Sahne 7 - Harekete Geçme Çağrısı (5 saniye)

**Anlatıcı:** {Eylem Çağrısı}

**Görseller:** {İngilizce, yürek ısıtan bir final sahnesi}

```

**Ekran Açıklaması Kuralları:**

- **İngilizce olmalı**, 50-80 kelime

- Şu formüle göre: Konu + Gerçekleştirilen eylem + Bulunduğu ortam + Bulunduğu ışık/atmosfer + Kameranın hareketi?

- **Kapak görselini/kitap başlığını belirtmeyin** (alt başlıklardan oluşturulan metin)

- Mümkün olduğunca somut senaryolar tanımlayın ve soyut kavramlardan kaçının.

**İsteğe bağlı ses türleri:**

- Şifa: `Nazik ve sakin kadın sesi`

- Gerilim/Gizem: `Derin, alçak erkek sesi`

- Taze ve sade tarz: Hafif ve canlı bir kadın sesi.

---

Adım 4: Video oluşturmak için işlem hattını kullanın.

**4.1 Storyboard JSON Dosyasını Kaydetme**

json

[

{"scene_id": 1, "prompt": "İngilizce görsel açıklama...", "narration": "Çince anlatım"},

{"scene_id": 2, "prompt": "İngilizce görsel açıklama...", "narration": "Çince anlatım"},

...

]

```

`D:\xiaohongshu_data\storyboard_{english_name}.json` dosyasına kaydedin.

**4.2 Tüm işlem hattının v3 olarak çağrılması**

Python

import sys, json

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

from seedance_client import SeedanceClient

istemci = SeedanceClient(api_key="YOUR_API_KEY")

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

storyboard = json.load(f)

sonuç = istemci.tam_video_oluştur(

storyboard = storyboard,

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

kitap_başlığı="Kitap Başlığı",

output_dir=r"D:\xiaohongshu_data",

ses_türü="nazik ve sakin kadın sesi",

altyazılı=Doğru,

)

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

```

**pipeline v3 otomatik olarak yürütülür:**

1. Kapak → Başlık Kartı (3 saniyelik kaydırma/yakınlaştırma + ses parçasını sessize alma)

2. Video klipleri sırayla oluşturun (her klip orijinal ses ve altyazı içerir).

3. Çapraz geçiş birleştirme (video çapraz geçişi + ses çapraz geçişi)

4. Son videoyu çıktı olarak verin.

**API Anahtar Yapılandırması:**

vurmak

VOLCENGINE_API_KEY=ark-xxx olarak ayarla

```

---

### Adım 5: Önizleme

`D:\preview_video_{name}_{date}.html` dosyasına aşağıdaki içeriği içeren bir HTML önizleme sayfası oluşturun:

- Video Oynatıcı

- Kitap başlığı, yazar, değerlendirme

- Anlatım Metni Versiyonu

- Xiaohongshu'da pembe temalı stiller

vurmak

başlangıç ​​"" "D:\preview_video_xxx.html"

```

**Lütfen kullanıcı onayını bekleyin.** Memnun kalmazsanız lütfen:

- Hikaye panosu komutunu ayarla → Yeniden oluştur

- Ses türünü değiştir → Yeniden oluştur

- Görsel açıklamayı ayarla → Yalnızca istemi değiştir

---

Adım 6: Xiaohongshu'ya gönderin

**6.1 Giriş Durumunu Kontrol Et** → MCP `check_login_status`

**6.2 Video Notları Metni Oluşturma** (Video senaryosu değil!)

- Başlık ≤ 20 karakter, birinci şahıs bakış açısı ve duygu dolu anlatım

- Ana metinde 200-300 kelime, 20'den fazla emoji

- 10-15 adet # işaretiyle başlayan etiket

**MCP 6.3 Sürümü Yayınlandı**

Python

MCP_URL = 'http://localhost:18060'

# Başlat → publish_content(başlık, içerik, video, etiketler)

# Kapsayıcının yolunu kullanan video yolu: /app/data/xxx.mp4

```

**6.4 Kayıt yayınlandı** → `published_books.json` dosyasına `"type": "video"` ekleyin.

---

## Çıktı Biçimi

```markdown

## Kitap önerisi videosu başarıyla oluşturuldu

**Kitap Adı**: 《{Kitap Adı}》

**Yazar**: {Yazar} | **Douban**: {Değerlendirme}

### Video Bilgileri

- Süre: ~{N} saniye (3 saniye başlık kartı + {M} sahne x 5 saniye)

- En Boy Oranı: 9:16 (Dikey)

- Çözünürlük: 720p

- Dosya boyutu: {N} MB

- Ses: Evet/Hayır

- Altyazılar: Dahili/Yok

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

### Bilgilendirme Bülteni

- Başlık: {başlık}

- Etiketler: {etiketler}

- Durum: {Başarılı/Başarısız}

```

---

## Temel Kurallar

1. **Yerel Ses Tercih Edilir** — Seedance 2.0, ses üretimini yerel olarak destekler; anlatımı komut isteminde belirtmeniz yeterlidir.

2. **Orijinal Altyazılar** — İstemi ekranda altyazı içeriğini belirtin; Seedance otomatik olarak senkronize altyazılar oluşturacaktır.

3. **Son Karenin Devamı** — Her bölüm, önceki bölümün son karesini başlangıç ​​görüntüsü olarak kullanır ve bu da daha tutarlı bir görsel akış sağlar.

4. **Storyboard çekimleri İngilizce olmalıdır** — Seedance, daha iyi görsel kalite için İngilizce çekimler kullanır.

5. **Birleşik Ses Türü** — Filmin tamamında aynı ses türü kullanılmıştır.

6. **Video en boy oranı 9:16** — Xiaohongshu dikey ekran

7. **Yayınlamadan önce kullanıcı onayı gereklidir** — Yayınlamadan önce önizlemenin tamamlanmasını bekleyin.

8. **Görüntü dosyalarının adları İngilizce olmalıdır** — Çince karakterler yükleme zaman aşımına neden olur.

9. **Video senaryosu ≠ Metin ve görüntü notları** — Senaryo, makale gibi değil, günlük konuşma dilinde yazılır.

10. **Ses Koruma Özelliği** — xfade video geçişi + acrossfade ses geçişi

## İşaret Kelimesi Referansı (Seedance 2.0 Kılavuzu)

### Ses Komut Şablonu

```

Seslendirmeli bir video oluşturun. `{voice_type}` seçeneği şu anlama gelir: "{anlatım içeriği}".

```

### Altyazı Talimat Şablonu

```

Ekranın alt kısmında "{altyazı içeriği}" şeklinde bir alt yazı görünür. Altyazı, ses ritmiyle mükemmel bir şekilde senkronize olmalıdır.

```

### Tam sahne komutlarına örnek

```

Seslendirmeli bir video oluşturun. Nazik, sakin bir kadın sesi, "Neden hep başkalarının beklentilerini karşılamaya çalıştığımızı hiç düşündünüz mü?" diyor. Sisli bir orman yolunda, bir yol ayrımında yalnız bir figür duruyor; güneş ışığı uzun ağaçların arasından süzülüyor, sıcak altın saat aydınlatması, yavaş yakınlaştırma, sığ alan derinliği. Ekranın alt kısmında, "Neden hep başkalarının beklentilerini karşılamaya çalıştığımızı hiç düşündünüz mü?" yazısı beliriyor. Altyazılar sesle mükemmel bir şekilde senkronize olmalıdır.

```

## Dosya Referansları

| Dosya | Amaç |

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

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | Seedance API + Yerel Ses/Altyazı + Birleştirme (v3) |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | Popüler Kitap Arama |

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | Yayınlanmış kayıtlar |

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | Kapak resmi alma (yedekleme) |

| `D:\xiaohongshu_data\` | Video ve Kapak Dosyası Çıkış Dizini |

## API Yapılandırması

| Parametre | Değer |

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

| Video Modeli | `doubao-seedance-2-0-fast-260128` |

| Ses Tipi | Nazik ve sakin kadın sesi (varsayılan) |

| Oran | `9:16` |

| Bölüm uzunluğu | 5 saniye |

| Başlık Kartı | 3 Saniyelik Kaydırma/Yakınlaştırma + Sesi Kapatma |

| çapraz geçiş | 0,5 saniyelik geçiş (video + ses) |