Manga Drama - AI 漫剧生成器

这是核心技能，实现从一张主角图到完整漫剧短剧的自动生成。

前置条件

1. 需要火山引擎 API Key，设置环境变量

   ARK_API_KEY

2. 安装 SDK：

   pip install 'volcengine-python-sdk[ark]'

工作流程

1. 剧本生成：根据用户输入的主题/情节，生成漫剧剧本
2. 分镜设计：将剧本拆解为多个分镜场景
3. 角色保持：基于用户提供的角色图片，保持角色一致性
4. 视频生成：为每个分镜生成视频片段
5. 结果输出：返回所有视频片段路径

使用方法

一句话生成漫剧

当用户要求生成漫剧时，执行：

python3 {baseDir}/scripts/generate_drama.py \
  --character "/path/to/character.png" \
  --theme "樱花树下的邂逅" \
  --scenes 4 \
  --style "anime_2d" \
  --output-dir "{workDir}/drama_output"

参数说明：

• --character

  ：主角图片路径（必填）

• --theme

  ：漫剧主题/情节描述（必填）

• --scenes

  ：分镜数量，默认 4，可选 3-8

• --style

  ：漫画风格，可选

  anime_2d

  ,

  ghibli

  ,

  japanese_healing

  ,

  chinese_ink

  ,

  chibi_cute

  等

• --ratio

  ：视频比例，默认

  16:9

  ，可选

  9:16

  （竖屏）

• --duration

  ：每个分镜时长，默认 5 秒

• --output-dir

  ：输出目录（必填）

自定义剧本生成

如果用户提供了详细的剧本：

python3 {baseDir}/scripts/generate_drama.py \
  --character "/path/to/character.png" \
  --script-file "/path/to/script.txt" \
  --style "ghibli" \
  --output-dir "{workDir}/drama_output"

剧本格式

自定义剧本文件格式示例：

【场景1】樱花树下初遇
镜头：远景，樱花飘落
动作：女主角站在树下，风吹起头发
时长：5秒

【场景2】回眸一笑
镜头：中景，正面
动作：女主角回头，微笑
时长：5秒

【场景3】花瓣飘落
镜头：特写，手部
动作：女主角伸手接住花瓣
时长：5秒

【场景4】夕阳西下
镜头：远景，背影
动作：女主角转身离开，夕阳余晖
时长：5秒

输出规范

1. 生成完成后，在

   --output-dir

   目录下创建：

   • script.txt

     ：生成的完整剧本

   • scene_1.mp4

     ,

     scene_2.mp4

     ...：各个分镜视频

   • drama_info.json

     ：漫剧元数据（场景数、时长等）

2. 向用户展示：

   • 生成的剧本内容
   • 每个分镜视频的预览
   • 视频文件路径列表

3. 提示用户：

   • 后续可以使用视频编辑工具将分镜合成为完整视频
   • 或者使用

     volcengine-video-understanding

     技能分析生成效果

提示词优化建议

主题描述示例：

樱花树下的邂逅：一名长发少女在春天的樱花树下等待，遇到了一只会说话的猫咪，展开了一段奇幻冒险

夏日海边回忆：少年和少女在海边相遇，一起追逐浪花，看日落，留下美好的夏日回忆

古风仙侠奇缘：白衣剑客在竹林中练剑，偶遇采药少女，一段仙侠情缘就此展开

注意事项

1. 此过程会消耗较多 token，建议使用火山引擎 Coding Plan 套餐
2. 每个分镜视频单独生成，保持角色一致性
3. 生成时间取决于分镜数量，请耐心等待

进阶资料

当需要扩展剧情结构、控制镜头节奏或把主题拆成分镜骨架时，读取

references/story-beats.md

。