---

ชื่อ: book-video-pipeline

คำอธิบาย: "ระบบสร้างวิดีโอแนะนำหนังสืออัตโนมัติ Xiaohongshu เวอร์ชัน 3 - Seedance 2.0: เสียงต้นฉบับ + คำบรรยาย, ทำงานอัตโนมัติเต็มรูปแบบตั้งแต่การเลือกหนังสือจนถึงการเผยแพร่"

ลิขสิทธิ์: MIT

เรียกใช้: "/book-video

---

# Xiaohongshu วิดีโอแนะนำหนังสือ สร้างไปป์ไลน์อัตโนมัติ เวอร์ชัน 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 วินาที):**

```มาร์คดาวน์

## สคริปต์วิดีโอแนะนำหนังสือ

**ชื่อหนังสือ**: 《{ชื่อหนังสือ}》

**สไตล์:** การบำบัด (โทนสีทองอบอุ่น)

### ฉากที่ 1 - ฉากเปิดเรื่องที่สร้างความตื่นเต้น (5 วินาที)

**คำบรรยาย:** {ประโยคเปิดเรื่องที่ดึงดูดสายตา}

**คำอธิบายภาพ:** {50-80 คำในภาษาอังกฤษ: ตัวแบบ + การกระทำ + สภาพแวดล้อม + มุมกล้อง + บรรยากาศ}

ฉากที่ 2 - หนังสือปรากฏขึ้น (5 วินาที)

**ผู้บรรยาย:** {บทนำโดยสังเขปเกี่ยวกับหนังสือเล่มนี้}

**ภาพประกอบ:** {เป็นฉากที่เกี่ยวข้องกับหนังสือเล่มหนึ่ง เป็นภาษาอังกฤษ}

### สตอรี่บอร์ด 3 - ผู้เขียน/ข้อมูลเบื้องต้น (5 วินาที)

**คำบรรยาย:** {ประวัติผู้เขียนหรือเรื่องราวเชิงสร้างสรรค์}

**ฉาก**: {ภาษาอังกฤษ, ฉากการเขียน, ห้องเรียน ฯลฯ}

### สตอรี่บอร์ด 4 - มุมมองหลักที่ 1 (5 วินาที)

**คำบรรยาย:** {มุมมองที่ซาบซึ้งหรือคำคมที่น่าจดจำ}

**ภาพประกอบ:** {ในภาษาอังกฤษ ภาพเปรียบเทียบที่สอดคล้องกับมุมมอง}

### ฉากที่ 5 - มุมมองหลักที่ 2 (5 วินาที)

**คำบรรยาย:** {มุมมองที่น่าสนใจหรือคำคมที่น่าจดจำอีกประการหนึ่ง}

**ภาพประกอบ:** {ในภาษาอังกฤษ ภาพเปรียบเทียบที่สอดคล้องกับมุมมอง}

### สตอรี่บอร์ด 6 - ข้อคิดส่วนตัว (5 วินาที)

**ผู้บรรยาย**: {ความรู้สึกที่แท้จริงของฉัน การเปลี่ยนแปลงที่ฉันได้รับหลังจากอ่านหนังสือเล่มนี้}

**ภาพประกอบ:** {ภาษาอังกฤษ, ฉากซึ้งกินใจ}

### ฉากที่ 7 - การกระตุ้นให้ดำเนินการ (5 วินาที)

**ผู้บรรยาย:** {คำกระตุ้นให้ดำเนินการ}

**ภาพประกอบ:** {ภาษาอังกฤษ, ฉากจบที่ซาบซึ้งใจ}

```

**กฎการเขียนคำอธิบายหน้าจอ:**

- **ต้องเป็นภาษาอังกฤษ**, 50-80 คำ

- ตามสูตร: ตัวแบบ + การกระทำที่กำลังเกิดขึ้น + สภาพแวดล้อม + แสง/บรรยากาศ + การเคลื่อนไหวของกล้อง?

- **ห้ามกล่าวถึงภาพปก/ชื่อหนังสือ** (ข้อความนี้สร้างจากคำบรรยายย่อย)

- อธิบายสถานการณ์เฉพาะเจาะจงให้มากที่สุดเท่าที่จะเป็นไปได้ และหลีกเลี่ยงแนวคิดที่เป็นนามธรรม

**ประเภทเสียงเพิ่มเติม:**

- การเยียวยา: `เสียงผู้หญิงที่อ่อนโยนและสงบ`

- ความตึงเครียด/ปริศนา: `เสียงทุ้มต่ำของผู้ชาย`

- สไตล์ที่สดใสและสะอาดตา: เสียงผู้หญิงที่เบาและมีชีวิตชีวา

---

ขั้นตอนที่ 4: ใช้ไปป์ไลน์เพื่อสร้างวิดีโอ

**4.1 การบันทึก Storyboard ในรูปแบบ JSON**

เจซอน

[

{"scene_id": 1, "prompt": "คำอธิบายภาพภาษาอังกฤษ...", "narration": "คำบรรยายภาษาจีน"},

{"scene_id": 2, "prompt": "คำอธิบายภาพภาษาอังกฤษ...", "narration": "คำบรรยายภาษาจีน"},

...

]

```

บันทึกไปยัง `D:\xiaohongshu_data\storyboard_{english_name}.json`

**4.2 การเรียกใช้ไปป์ไลน์เวอร์ชัน 3 อย่างสมบูรณ์**

ไพธอน

import sys, json

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

จาก seedance_client นำเข้า SeedanceClient

ไคลเอ็นต์ = SeedanceClient(api_key="YOUR_API_KEY")

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

storyboard = json.load(f)

ผลลัพธ์ = ลูกค้าสร้างวิดีโอแบบเต็ม(

สตอรี่บอร์ด = สตอรี่บอร์ด

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']})")

```

**ไปป์ไลน์เวอร์ชัน 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(title, content, video, tags)

# เส้นทางไฟล์วิดีโอโดยใช้เส้นทางของคอนเทนเนอร์: /app/data/xxx.mp4

```

**6.4 บันทึกได้รับการเผยแพร่แล้ว** → เพิ่ม `"type": "video"` ลงใน `published_books.json`

---

## รูปแบบผลลัพธ์

```มาร์คดาวน์

วิดีโอแนะนำหนังสือสร้างสำเร็จแล้ว

**ชื่อหนังสือ**: 《{ชื่อหนังสือ}》

**ผู้แต่ง**: {Author} | **Douban**: {Rating}

### ข้อมูลวิดีโอ

- ระยะเวลา: ประมาณ {N} วินาที (ไตเติ้ลการ์ด 3 วินาที + ฉาก {M} ฉาก x 5 วินาที)

- อัตราส่วนภาพ: 9:16 (แนวตั้ง)

- ความละเอียด: 720p

- ขนาดไฟล์: {N} MB

- เสียง: ใช่/ไม่ใช่

- คำบรรยาย: ฝังในไฟล์/ไม่มี

- เส้นทาง: `D:\xiaohongshu_data\{name}_final.mp4`

### การเผยแพร่ข้อมูล

- ชื่อเรื่อง: {title}

- แท็ก: {tags}

- สถานะ: {สำเร็จ/ล้มเหลว}

```

---

## กฎสำคัญ

1. **แนะนำให้ใช้เสียงต้นฉบับ** — Seedance 2.0 รองรับการสร้างเสียงโดยตรง เพียงแค่ระบุเสียงบรรยายในข้อความแจ้งเตือน

2. **คำบรรยายแบบเนทีฟ** — ระบุเนื้อหาคำบรรยายในช่องป้อนข้อความ แล้ว Seedance จะสร้างคำบรรยายที่ซิงโครไนซ์โดยอัตโนมัติ

3. **การต่อภาพจากเฟรมสุดท้าย** — แต่ละส่วนจะใช้เฟรมสุดท้ายของส่วนก่อนหน้าเป็นภาพเริ่มต้น ทำให้ภาพมีความต่อเนื่องมากขึ้น

4. **ภาพในสตอรี่บอร์ดควรเป็นภาษาอังกฤษ** — Seedance ใช้ภาพภาษาอังกฤษเพื่อให้ได้คุณภาพภาพที่ดีขึ้น

5. **ประเภทเสียงที่เป็นเอกภาพ** — ภาพยนตร์ทั้งเรื่องใช้ประเภทเสียงเดียวกัน

6. **อัตราส่วนภาพวิดีโอ 9:16** — หน้าจอแนวตั้งของเสี่ยวหงซู

7. **ต้องได้รับการยืนยันจากผู้ใช้ก่อนเผยแพร่** — โปรดรอให้การแสดงตัวอย่างเสร็จสมบูรณ์ก่อนเผยแพร่

8. **ชื่อไฟล์ภาพต้องเป็นภาษาอังกฤษ** — หากใช้ตัวอักษรจีนจะทำให้การอัปโหลดล้มเหลว

9. **สคริปต์วิดีโอ ≠ ข้อความและบันทึกภาพ** — สคริปต์เขียนด้วยภาษาที่ใช้ในการสนทนา ไม่ใช่ในรูปแบบบทความ

10. **การรักษาคุณภาพเสียงเมื่อสลับโหมด** — การเปลี่ยนภาพแบบ xfade + การเปลี่ยนเสียงแบบ acrossfade

## คู่มืออ้างอิงคำสำคัญ (คู่มือ Seedance 2.0)

### แม่แบบคำสั่งเสียง

```

สร้างวิดีโอพร้อมเสียงบรรยาย ตัวเลือก `{voice_type}` ระบุว่า: "{narration 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 วินาที |