LocalMiniDrama openclaw-skill实战：用自然语言控制短剧生成全流程（REST API完全参考）-开发者社区

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 短剧，从一句话开始，到成片下载，全程数据不出本机。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考