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/LocalMiniDramaLocalMiniDrama是一款完全开源的本地 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_urlhttp://localhost:5679后端地址云服务器改成你的服务器 IPdefault_aspect_ratio16:9画面比例竖屏短剧改9:16default_video_duration5单个视频片段时长秒技能通过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.portcd 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_urlhttp://你的服务器IP:5679配置完成。现在打开 OpenClaw 对话框输入配置一下通义千问或帮我创建一个仙侠短剧技能就会被触发词自动唤醒。 一句自然语言跑通短剧生成全流程openclaw-skill 内置了一条严格排序的 12 步标准工作流完整指令见 openclaw-skill/SKILL.md。你只说帮我制作这个短剧它会依次执行步骤自然语言意图背后调用的 API1创建项目POST /api/v1/dramas2流式生成剧本POST /api/v1/generation/story/stream3保存剧本到各集PUT /api/v1/dramas/{drama_id}/episodes4提取角色POST /api/v1/generation/characters5提取场景POST /api/v1/images/episode/{episode_id}/backgrounds/extract6提取道具POST /api/v1/episodes/{episode_id}/props/extract7生成角色形象图POST /api/v1/characters/{id}/generate-image8生成场景图POST /api/v1/scenes/{scene_id}/generate-image9生成分镜POST /api/v1/episodes/{episode_id}/storyboards10批量生成图片POST /api/v1/images/episode/{episode_id}/batch11批量生成视频POST /api/v1/videos/episode/{episode_id}/batch12合成成片并下载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?page1page_size20GET分页列出所有短剧项目/dramasPOST新建项目body 含title、style、metadata.aspect_ratio/dramas/{drama_id}GET / PUT / DELETE详情 / 更新 / 软删除/dramas/statsGET项目统计/dramas/{drama_id}/episodesPUT保存集数剧本字段名是script_content不是content/dramas/{drama_id}/exportGET导出工程 ZIP/dramas/importPOST导入工程 ZIPmultipart 上传/dramas/import-novelPOST小说文本导入自动拆章生成剧集结构剧本 / 角色 / 场景 / 道具接口方法说明/generation/story/streamPOST流式生成剧本SSE推荐/generation/storyPOST非流式生成剧本/generation/charactersPOSTAI 提取剧本角色异步任务/dramas/{drama_id}/charactersGET / PUT获取 / 手动保存角色/characters/{character_id}/generate-imagePOST生成角色形象图/characters/{character_id}/generate-four-view-imagePOST生成角色四视图/characters/{character_id}/extract-from-imagePOST从上传图片反推角色描述/episodes/{episode_id}/extract-backgroundsPOST从剧本提取场景/scenes/{scene_id}/generate-imagePOST生成场景图/episodes/{episode_id}/extract-propsPOST提取道具/props/{prop_id}/generatePOST生成道具图/character-library/scene-library/prop-libraryCRUD三个全局素材库跨项目复用分镜管理接口方法说明/episodes/{episode_id}/storyboardsPOST / GET生成分镜异步/ 查询分镜列表/storyboards/{storyboard_id}GET / PUT / DELETE单条分镜详情 / 编辑台词动作 / 删除/storyboards/{storyboard_id}/insert-beforePOST在指定位置前插入新分镜/storyboards/batch-infer-paramsPOST批量推断摄影参数景别/运镜毫秒级无需 AI/storyboards/{storyboard_id}/polish-promptPOSTAI 优化分镜画面描述/storyboards/{storyboard_id}/frame-promptPOST生成首帧/尾帧提示词/storyboards/{storyboard_id}/upscalePOST分镜图片 2 倍超分专业分镜编辑界面景别、运镜、灯光、景深等电影级参数均可调整图片 / 视频 / 合成接口方法说明/images/episode/{episode_id}/batchPOST批量生成图片types可同时含image和video/images/{image_gen_id}GET查询图片任务状态/storyboards/{storyboard_id}/imagesGET获取分镜关联图片/storyboards/{storyboard_id}/uploadPOST手动上传图片覆盖分镜参考图/videos/episode/{episode_id}/batchPOST批量生成视频/videos/{video_gen_id}GET查询视频任务状态/episodes/{episode_id}/merge-statusGET查询合成进度/video-mergesPOST / GET触发合成merge_type: concatenate/ 查询合成任务/episodes/{episode_id}/downloadGET下载最终成片场景库每个场景都可一键生成图片并加入本集跨项目复用异步任务与 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.0PUT /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），仅供参考