lujiaheng-artpivot Manga Drama - AI 漫剧生成器
这是核心技能，实现从一张主角图到完整漫剧短剧的自动生成。
前置条件
- 需要火山引擎 API Key，设置环境变量
ARK_API_KEY - 安装 SDK：
pip install 'volcengine-python-sdk[ark]'
工作流程
- 剧本生成：根据用户输入的主题/情节，生成漫剧剧本
- 分镜设计：将剧本拆解为多个分镜场景
- 角色保持：基于用户提供的角色图片，保持角色一致性
- 视频生成：为每个分镜生成视频片段
- 结果输出：返回所有视频片段路径
使用方法
一句话生成漫剧
当用户要求生成漫剧时，执行：
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秒
输出规范
生成完成后，在
--output-dir目录下创建：script.txt：生成的完整剧本scene_1.mp4,scene_2.mp4...：各个分镜视频drama_info.json：漫剧元数据（场景数、时长等）
向用户展示：
- 生成的剧本内容
- 每个分镜视频的预览
- 视频文件路径列表
提示用户：
- 后续可以使用视频编辑工具将分镜合成为完整视频
- 或者使用
volcengine-video-understanding技能分析生成效果
提示词优化建议
主题描述示例：
樱花树下的邂逅：一名长发少女在春天的樱花树下等待，遇到了一只会说话的猫咪，展开了一段奇幻冒险
夏日海边回忆：少年和少女在海边相遇，一起追逐浪花，看日落，留下美好的夏日回忆
古风仙侠奇缘：白衣剑客在竹林中练剑，偶遇采药少女，一段仙侠情缘就此展开
注意事项
- 此过程会消耗较多 token，建议使用火山引擎 Coding Plan 套餐
- 每个分镜视频单独生成，保持角色一致性
- 生成时间取决于分镜数量，请耐心等待
进阶资料
当需要扩展剧情结构、控制镜头节奏或把主题拆成分镜骨架时，读取 references/story-beats.md。