用代码拍电影:短片、广告与音乐视频
用代码制作短片、广告和音乐视频。Cinecode 引导 Claude Code 或 Cursor 完成剧本、视觉方向、动画、声音和 MP4 交付,可选择快速模式或分阶段的电影模式。
可用于 Claude Code · Cursor
前置要求
- Node.js 22+
- Python 3.9+
- ffmpeg
- Chrome / Chromium / Edge
- GPU
概览
你会得到什么
- 快速模式:画面与 Web Audio 声音集中在一个 film.html 中,先出低分辨率草稿,局部修改后导出 MP4。
- 电影模式:按路线图、剧本、风格静帧、动态分镜、画面渲染与分层声音制作较大的项目。
- 视觉方向、可选旁白、配乐和音效设计、质量检查,以及 -14 LUFS 的最终声音母版。
教程
把一个想法做成有画面和声音的短片
你有一个题材或产品,想做成短片,却不知道怎样把剧本、镜头、动画和声音连起来。Cinecode 把这些步骤组织成 AI 编程工作流:助手用代码制作画面和声音,先展示预览,再渲染成 MP4。
与 Lemo、Cook 和 rea-video 怎么选
- lemo-opuscar从多种风格和样片出发制作影片。Cinecode 收入了其中的风格配方,并保留许可说明;它另有自己的快速制作、导演卡、声音和检查流程。
- Cook重点是对照参考反复制作和改进作品。
- rea-video重点是拆解参考视频的制作方法,整理分镜和复刻计划。
Cinecode 的起点可以只是一个想法,也可以是你的产品资料、歌曲或参考视频。本次先做一支 15 秒咖啡广告,学会确认视觉方向、检查草稿和提出局部修改。
先看作品怎样表达材质与动作
上方第一个视频由官方 GIF 合集转换而来,长 30 秒、560×316、8 fps,无声音。它用于观察多种画面表达,不代表完整作品的帧率或声音效果。
另外两张是官方静帧:
- 钟表广告:观察金属机芯、雕刻线条和斜向光线怎样突出产品细节。
- 烘焙店广告:观察暖灯、砖炉、面包和蒸汽怎样共同表现“刚出炉”。
练习时沿用这种描述方式,把“有电影感”改成可见的对象、材质、光线和动作。例如咖啡广告可以关注杯沿、液面反光、蒸汽和倒入动作,再选择适合它们的画风。
安装并准备工作目录
使用能运行本机工具的 Claude Code 或 Cursor。环境需要 Node.js 22+、Python 3.9+、ffmpeg,以及 Chrome、Chromium 或 Edge;制作成片还需准备浏览器能使用的 GPU,例如近年的 Mac 或已安装显卡驱动的 PC。
- 在 AI 编程工具里发送:“从 https://github.com/sarpstar/cinecode 安装 cinecode 技能。”也可以在终端中手动安装,二选一:
# Claude Code
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode
# Cursor
git clone https://github.com/sarpstar/cinecode.git ~/.cursor/skills/cinecode
- 安装后开启新对话,并选择一个空白文件夹作为影片工作目录。技能安装目录保存工具包,工作目录保存你的影片,两者分开。
- 让助手检查 Node、Python、ffmpeg、浏览器和 GPU。缺少工具时,按它列出的安装步骤补齐;看到它报告实际使用的软件和工作目录后,再进入制作。
技能通过自然语言触发,不需要额外的插件斜杠命令。首次练习不使用旁白和外部音乐,因此不需要配置语音服务密钥。之后需要旁白时,可提供自己的配音,或按助手说明配置相应服务。
选择快速模式,确认两张场景预览
快速模式把画面、时间线和 Web Audio 声音放在一个 film.html 中,适合从短片开始。电影模式多出剧本、风格静帧、动态分镜等阶段,留到较长或研究材料较多的项目再用。
- 在空白工作目录的 AI 对话中发送下面的本站练习请求:
用 cinecode 制作一支 15 秒、9:16 竖屏咖啡广告。
使用快速模式,目的选择广告与产品。
主题是“一颗咖啡豆到一杯热咖啡”,使用虚构店名“晨间咖啡”。
不要旁白。音乐由代码编写,配合倒咖啡和杯子落桌的音效。
先推荐两个视觉方向,说明材质、光线和主要动作。
屏幕文字用中文,选能显示这些汉字的字体。
先展示节奏安排和导演卡,再展示开场与另一场景的静帧。
等我确认这两张图后再做草稿,不直接完成全片。
- 选择视觉方向。看导演卡是否把画幅、颜色、镜头、节奏、文字和声音写具体;用“蒸汽更细”“主光从左侧来”等可检查的描述调整它。
- 查看两张场景静帧,确认咖啡豆、杯子和液面是否可辨,中文有没有缺字或过小。确认后再让助手继续制作低分辨率草稿。
两张静帧用于判断方向和细节,动作与声音要到草稿里检查。这个练习明确选择代码配乐;使用现成音轨时,应先试听候选或提供自己的音轨,再确定节奏。
检查草稿,做一次局部修改
播放助手提供的草稿,先看完整一遍,再针对问题提出修改:
- 开场是否已经发生动作,咖啡从哪里来、怎样到杯里是否连贯。
- 中文在手机大小下是否看得清,店名是否有足够停留时间。
- 倒入、落杯等音效是否对准相应动作,配乐是否盖过主要声音。
草稿降低的是分辨率,不是省略必要的物体和材质。静帧看不出的节奏问题,应在草稿阶段解决。
然后发送一个范围明确的修改请求:
只调整结尾:把“晨间咖啡”的停留时间增加 1 秒。
总时长仍为 15 秒,请从前一个过渡中腾出这 1 秒。
保留店名文字、字体、杯子材质和音乐风格;同步调整受影响的音效时间。
先给修改后的草稿,不重新设计整片。
播放新草稿,对比结尾停留、过渡和音效。这样的反馈把要改的对象、幅度与相关时间变化说清楚,助手也更容易只修改相关部分。
导出 MP4,保留可继续修改的工程
草稿确认后,让助手执行最终渲染与质量检查。快速模式的工具把静帧、草稿和最终输出分别组织为 tools/make.py 的 stills、draft、final 步骤;让助手按当前工程执行即可。
交付时确认它给出影片文件夹和顶层的 <title>.mp4 路径。打开成片,重新检查尺寸、时长、中文与声音;工具流程会做响度处理,目标为 -14 LUFS。
同时保留 film.html、STATE.md、素材和声音文件。STATE.md 记录项目选择与进度,之后可让助手读取它继续。用了外部素材时,保留 LICENSES.csv,以及生成的署名文件;发布时按文件中的要求署名。
最终 MP4 是要播放或上传的文件,可编辑工程则用于改文案、换产品或调整镜头。代码修改后,需要重新渲染才能更新视频。
换成自己的产品、故事或歌曲
把咖啡例子换成自己的资料时,先填出这些信息:
用 cinecode 制作:[短片/产品广告/音乐视频]。
主题与观众:[说给谁看,希望看完记住什么]。
时长与画幅:[秒数,9:16/16:9/1:1]。
必须出现:[产品细节、角色、动作或文字]。
视觉方向:[参考或希望比较的两种方向]。
声音:[旁白语言/不旁白;自己的音乐路径/试听候选/代码配乐/无音乐]。
已有素材:[Logo、图片、歌曲、录音等文件路径]。
先建议适合的模式,展示分镜与预览,再进入整片制作。
音乐视频要把歌曲交给助手测量节拍,再让切换和动作对齐音乐。较长的纪录片、章节式讲解或需要研究与档案素材的项目,可选择电影模式,依次确认路线图、剧本、风格静帧和动态分镜,再制作草稿与成片。
想把同一种视听风格做成系列时,可在完成后要求保存格式。下一集沿用视觉与声音的组织方式,故事、镜头和文字根据新主题重新制作。