LocalMiniDrama openclaw-skill实战：用自然语言控制短剧生成全流程（REST API完全参考）
【免费下载链接】LocalMiniDrama🎬 seedance2接入 开源本地 AI 短剧 & 漫剧生成工具 —— 从故事到成片一站式完成，数据不出本机，短剧工作流管理平台，高灵活度，AI真人剧，AI漫剧本地搞定。 Open-source local AI short drama maker: story → storyboard → video, fully offline, your data stays yours. 纳米流水线项目地址: https://gitcode.com/gh_mirrors/lo/LocalMiniDrama
LocalMiniDrama是一款完全开源的本地 AI 短剧 & 漫剧生成工具，覆盖"剧本 → 角色 → 分镜 → 图片 → 视频 → 合成成片"的完整流水线，数据全部保存在本机。而它的openclaw-skill技能包，让你直接用自然语言指挥这套工具完成短剧生成全流程——不用记接口、不用写代码，一句"帮我做一个仙侠短剧"就能跑完从建项目到出成片的 12 个步骤。本文是 openclaw-skill 的实战指南，同时附赠一份完整的REST API 参考，方便你用任意 HTTP 工具直接调用后端。
🤖 openclaw-skill 是什么？能干什么
openclaw-skill 位于仓库根目录的openclaw-skill/文件夹，它把 LocalMiniDrama 后端的全部 REST API 封装成了"技能指令"，安装到 OpenClaw（小龙虾）之后，你只需要在对话框里输入自然语言，AI 助手就会自动翻译成对后端的 HTTP 请求：
| 你说的一句话 | 技能自动执行的动作 |
|---|---|
| "帮我创建一个仙侠短剧" | 创建项目 + 流式生成多集剧本 |
| "生成本集分镜" | 为当前集数批量生成分镜脚本 |
| "给李逍遥生成一张图" | 定位角色并触发角色形象图生成 |
| "批量生成视频" | 逐镜触发视频生成任务 |
| "合成这集视频" | 串联所有分镜视频并合成成片 |
| "这集做好了吗" | 查询合成进度并汇报结果 |
技能的核心配置只有 3 项（见 openclaw-skill/skill.json）：
| 配置项 | 默认值 | 说明 |
|---|---|---|
base_url | http://localhost:5679 | 后端地址，云服务器改成你的服务器 IP |
default_aspect_ratio | 16:9 | 画面比例，竖屏短剧改9:16 |
default_video_duration | 5 | 单个视频片段时长（秒） |
技能通过http工具发送请求、通过memory工具记住当前的drama_id和episode_id（定义见 openclaw-skill/tools.json），所以对话过程中你不需要重复报项目 ID。
LocalMiniDrama 首页：所有短剧项目卡片一览，支持一键导入示例项目
🚀 三步安装与配置
第 1 步：获取项目
git clone https://gitcode.com/gh_mirrors/lo/LocalMiniDrama第 2 步：启动后端服务
后端是 Node.js + Express + SQLite，默认监听5679端口（见 backend-node/configs/config.yaml 的server.port）：
cd backend-node npm install npm run migrate npm start启动后所有接口统一挂载在/api/v1前缀下（见 backend-node/src/app.js）。
第 3 步：安装技能并配置地址
# 本地安装 cp -r ./openclaw-skill ~/.openclaw/workspace/skills/local-mini-drama # 配置后端地址（云服务器用户） openclaw skill config local-mini-drama --set base_url=http://你的服务器IP:5679配置完成。现在打开 OpenClaw 对话框，输入"配置一下通义千问"或"帮我创建一个仙侠短剧"，技能就会被触发词自动唤醒。
🎬 一句自然语言，跑通短剧生成全流程
openclaw-skill 内置了一条严格排序的 12 步标准工作流（完整指令见 openclaw-skill/SKILL.md）。你只说"帮我制作这个短剧"，它会依次执行：
| 步骤 | 自然语言意图 | 背后调用的 API |
|---|---|---|
| 1 | 创建项目 | POST /api/v1/dramas |
| 2 | 流式生成剧本 | POST /api/v1/generation/story/stream |
| 3 | 保存剧本到各集 | PUT /api/v1/dramas/{drama_id}/episodes |
| 4 | 提取角色 | POST /api/v1/generation/characters |
| 5 | 提取场景 | POST /api/v1/images/episode/{episode_id}/backgrounds/extract |
| 6 | 提取道具 | POST /api/v1/episodes/{episode_id}/props/extract |
| 7 | 生成角色形象图 | POST /api/v1/characters/{id}/generate-image |
| 8 | 生成场景图 | POST /api/v1/scenes/{scene_id}/generate-image |
| 9 | 生成分镜 | POST /api/v1/episodes/{episode_id}/storyboards |
| 10 | 批量生成图片 | POST /api/v1/images/episode/{episode_id}/batch |
| 11 | 批量生成视频 | POST /api/v1/videos/episode/{episode_id}/batch |
| 12 | 合成成片并下载 | POST /api/v1/video-merges→GET /api/v1/episodes/{episode_id}/download |
⚠️顺序至关重要：必须先提取角色/场景/道具，再让分镜 AI 开工。顺序颠倒会导致分镜里
characters为空、场景为 null，镜头和人物对不上。这也是技能文档里用"错误流程（已废弃）"专门标出的坑。
画布模式下的分镜生成工作流：角色、场景、分镜词、图片、视频节点一目了然
📚 REST API 完全参考
如果你想绕过 OpenClaw、直接用 Postman 或脚本调用，下面是各模块的核心接口清单（基础路径http://localhost:5679/api/v1）。
剧集项目管理
| 接口 | 方法 | 说明 |
|---|---|---|
/dramas?page=1&page_size=20 | GET | 分页列出所有短剧项目 |
/dramas | POST | 新建项目，body 含title、style、metadata.aspect_ratio |
/dramas/{drama_id} | GET / PUT / DELETE | 详情 / 更新 / 软删除 |
/dramas/stats | GET | 项目统计 |
/dramas/{drama_id}/episodes | PUT | 保存集数剧本（字段名是script_content，不是content！） |
/dramas/{drama_id}/export | GET | 导出工程 ZIP |
/dramas/import | POST | 导入工程 ZIP（multipart 上传） |
/dramas/import-novel | POST | 小说文本导入，自动拆章生成剧集结构 |
剧本 / 角色 / 场景 / 道具
| 接口 | 方法 | 说明 |
|---|---|---|
/generation/story/stream | POST | 流式生成剧本（SSE，推荐） |
/generation/story | POST | 非流式生成剧本 |
/generation/characters | POST | AI 提取剧本角色（异步任务） |
/dramas/{drama_id}/characters | GET / PUT | 获取 / 手动保存角色 |
/characters/{character_id}/generate-image | POST | 生成角色形象图 |
/characters/{character_id}/generate-four-view-image | POST | 生成角色四视图 |
/characters/{character_id}/extract-from-image | POST | 从上传图片反推角色描述 |
/episodes/{episode_id}/extract-backgrounds | POST | 从剧本提取场景 |
/scenes/{scene_id}/generate-image | POST | 生成场景图 |
/episodes/{episode_id}/extract-props | POST | 提取道具 |
/props/{prop_id}/generate | POST | 生成道具图 |
/character-library/scene-library/prop-library | CRUD | 三个全局素材库，跨项目复用 |
分镜管理
| 接口 | 方法 | 说明 |
|---|---|---|
/episodes/{episode_id}/storyboards | POST / GET | 生成分镜（异步）/ 查询分镜列表 |
/storyboards/{storyboard_id} | GET / PUT / DELETE | 单条分镜详情 / 编辑台词动作 / 删除 |
/storyboards/{storyboard_id}/insert-before | POST | 在指定位置前插入新分镜 |
/storyboards/batch-infer-params | POST | 批量推断摄影参数（景别/运镜，毫秒级无需 AI） |
/storyboards/{storyboard_id}/polish-prompt | POST | AI 优化分镜画面描述 |
/storyboards/{storyboard_id}/frame-prompt | POST | 生成首帧/尾帧提示词 |
/storyboards/{storyboard_id}/upscale | POST | 分镜图片 2 倍超分 |
专业分镜编辑界面：景别、运镜、灯光、景深等电影级参数均可调整
图片 / 视频 / 合成
| 接口 | 方法 | 说明 |
|---|---|---|
/images/episode/{episode_id}/batch | POST | 批量生成图片，types可同时含image和video |
/images/{image_gen_id} | GET | 查询图片任务状态 |
/storyboards/{storyboard_id}/images | GET | 获取分镜关联图片 |
/storyboards/{storyboard_id}/upload | POST | 手动上传图片覆盖分镜参考图 |
/videos/episode/{episode_id}/batch | POST | 批量生成视频 |
/videos/{video_gen_id} | GET | 查询视频任务状态 |
/episodes/{episode_id}/merge-status | GET | 查询合成进度 |
/video-merges | POST / GET | 触发合成（merge_type: concatenate）/ 查询合成任务 |
/episodes/{episode_id}/download | GET | 下载最终成片 |
场景库：每个场景都可一键生成图片并加入本集，跨项目复用
异步任务与 AI 配置
所有生成类接口都返回{ "task_id": "...", "status": "pending" }，统一用下面这个接口轮询：
GET /api/v1/tasks/{task_id}状态流转为pending → processing → completed / failed，响应里带progress百分比和失败原因。技能内置的轮询策略：初始等 500ms，之后每 2 秒查一次，超过 2 分钟视为超时（后台继续跑）。
AI 服务商配置相关接口：
| 接口 | 说明 |
|---|---|
GET/POST /ai-configs | 查看 / 创建 AI 配置（文本、图片、视频三类模型独立配置） |
POST /ai-configs/{id}/test | 测试 API Key 连通性 |
POST /ai-configs/preset/dashscope | 一键预设通义千问 |
POST /ai-configs/preset/volcengine | 一键预设火山引擎（豆包 / Seedance 2.0） |
PUT /ai-configs/bulk-update-key | 批量更新密钥 |
💡 常见问答与避坑指南
| 问题 | 答案 |
|---|---|
| "这集视频做好了吗？" | 技能会自动查/episodes/{episode_id}/merge-status并汇报进度 |
| "我有篇小说，帮我做短剧" | 走/dramas/import-novel自动拆章（建议单次 ≤30 章，超长文本分段上传） |
生图/生视频报AI_ERROR | 检查三类模型对应的 API Key 是否配置、账户额度是否充足 |
base_url怎么填 | 必须带http://或https://协议头，末尾不带/ |
| 想做竖屏短剧 | 项目metadata.aspect_ratio和视频参数都设为9:16 |
| 导出/导入工程 | 仅支持 LocalMiniDrama 自己导出的 ZIP 格式 |
角色形象生成：AI 自动从剧本提取角色并生成多视图形象，保证连续镜头外貌一致
✅ 总结
openclaw-skill 的价值在于把 LocalMiniDrama 的12 步短剧生产流水线压缩成了一次自然语言对话：它替你记着项目 ID、排着执行顺序、轮着任务进度，你只需要在关键时刻说"给这个分镜的运镜改成环绕镜头"这样的微调指令。而本文的 REST API 参考则是"逃生舱口"——任何你想做的自动化（批量跑项目、接入自己的 CI、写监控脚本），都能直接对着这份清单调用后端。本地跑通之后，一部属于你的 AI 短剧，从一句话开始，到成片下载，全程数据不出本机。
【免费下载链接】LocalMiniDrama🎬 seedance2接入 开源本地 AI 短剧 & 漫剧生成工具 —— 从故事到成片一站式完成，数据不出本机，短剧工作流管理平台，高灵活度，AI真人剧，AI漫剧本地搞定。 Open-source local AI short drama maker: story → storyboard → video, fully offline, your data stays yours. 纳米流水线项目地址: https://gitcode.com/gh_mirrors/lo/LocalMiniDrama
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
