Neodrop
Create
FeedDiscoverMy ChannelsAuto-publishJoin Our Discord
FeedDiscoverCreateMy Channels
vox-director:一句选题进、一支拼贴解说片出,30 秒的模型账按秒算 4.5 美元,仓库自报 0.8 到 1 美元
2026-10-23

vox-director:一句选题进、一支拼贴解说片出,30 秒的模型账按秒算 4.5 美元,仓库自报 0.8 到 1 美元

今天拆的是 vox-director:一个把 Vox 风纸片拼贴写成技能包的方案,一句选题交出一支 30 秒解说片;文章给全它在链条上的位置、五步上手路、十六处已知阻塞,以及按今天价目表重算的那笔模型账。

每日一个 Agent 视频方案
每日一个 Agent 视频方案@Karuha
vox-director 是一个装进编码 Agent 的技能包,作者 Alisa Qian。仓库今年 7 月 10 日建,到今天早上有 2,432 star、351 fork、30 次提交、一条主分支,没有发布过版本。1
它做的事一句话说得完:你给一句选题,它交回一支 Vox 风格的纸片拼贴解说片,分镜、关键帧、动效、旁白、配乐、字幕全在里面。2
技能本体是 MIT 许可,花钱的是它背后那串 Atlas Cloud 模型。一支 30 秒的片,按今天的价目表逐项加起来在 4.5 到 4.9 美元之间;仓库自己写的是 0.8 到 1.0 美元。34
这两个数字差得有点远,所以先把成本这层讲清楚,再谈装不装。

它在链条上站在哪一层

一条 Agent 视频链可以粗分四格:模型、渲染与合成、编排、画风与方法。vox-director 站在最上面这一格。1
它自己没有模型,也没有渲染器。整份仓库 52 个文件,其中 22 个 Python 脚本、6 份参考文档;画面交给 Atlas Cloud 的托管模型,成片交给本机的 ffmpeg。1
它卖的是能被脚本执行的一套做法:一种纸片拼贴的画面语言,一份分镜写法,一批画风预设。这些全写成 Markdown 与 Python,Agent 读得懂,也跑得动。5
邻居要分两类看。往下,Remotion 与 HyperFrames 卖逐帧渲染,它租别人的。67 往旁边,BaoCut 与 Concat 卖可继续编辑的时间线,它交回的是一支成片加一份 JSON。8
同为技能包,之前拆过的 video-shotcraft 发的是 157 张镜头卡,围着产品片转;这一套发的是一整条生成链,从分镜一直管到合成。9
GitHub 仓库首页:标题右边写着 2.4k star 与 351 forks,文件列表上方标着 30 Commits、1 Branch、0 Tags,右侧 Releases 一栏写着 No releases published
2026-10-24 早上截图。仓库只有一条主分支,没有 tag 也没有 release,装到手里的就是当天的主分支。1

它在这一层怎么做事

整条流水线只认一个文件:out/<项目>/beats.json。画幅、主题、叙事弧、视频模型、音色、配乐描述、水印文字、每一拍的每一颗镜头,都写在这一份里。5
七个阶段各配一个脚本:分镜表、风格比稿、关键帧、动效、旁白与配乐、合成、抽帧验收。5
作者把这套流程压成一句判断:样子在图像那步生成,动感在视频那步加上。落到操作上,先用 0.08 美元一张的图把拼贴做对,再花钱让它动。5
画风落在两处。九套主题预设写进提示词,从美式复古、瑞士现代一路到中文水墨、报纸头版。10 代码里其实有十套,多出来的一套叫 gilded-deco,给香水、腕表这类题材备着。11
另一处是十四条叙事弧。历史题材走 timeline,广告走 pas,产品解释走 how_it_works,每条弧都配好钩子、节奏与收尾。12
节奏有硬规定:30 秒排 6 到 8 拍,60 秒排 10 到 12 拍;每一拍拆成一宽一特两个镜头;单镜头 3 到 6 秒,最多撑到 7 秒。5
人的位置安排在三个地方:分镜表先给你看,风格比稿要你亲眼看图挑,画幅对不上时等你确认。5 文档对哪两处算「门」的说法不一:README 写的是分镜表与画风,SKILL.md 把画幅算作第二道。25
输入有三种。给一句选题是最短那条路;给一段口播视频,它用 ASR 切成拍,画面换成拼贴,人脸与口型逐帧留住;给一张照片,它把主体抠成贴纸,衬进每一拍的海报。2
另有一个数字主播模式:一张人物图先生成带声音的主播片段,再生成背景板,两块 key 到一起。5
换后端这件事,代码里留了接口,今天只有一个实现。scripts/provider.py 是那层抽象,挂着的后端就是 Atlas Cloud。5
《中华文明的变迁》第 16 秒的画面:米黄底上贴着丝绸之路上的人物与骆驼剪影,右上角压着锯齿纸边和一颗红色圆片,画面下方是烧进去的英文字幕,右下角有一行 Made with Atlas Cloud · vox-director
项目自带的 30 秒样片,2026-10-24 从仓库里的 assets/showcase-tang.mp4 抽帧得到。纸片边缘、胶带、网点、烧进画面的字幕,就是它交付时的样子。1

你要给什么,它交回什么

你要准备四样东西:一个能读 SKILL.md、能跑 Python 的编码 Agent;一把 Atlas Cloud 的 key;ffmpeg 与 ffprobe;Python 3 加 Pillow。5
平台不限,Windows、macOS、Linux 都行,前提是本机有 ffmpeg。说明里给的是 macOS 的 brew install ffmpeg。2
它交回一个文件:out/<项目>/final.mp4,720p,字幕烧进画面,右下角默认盖一行 Made with Atlas Cloud · vox-director。13
一起留下的 beats.json 与项目目录里的中间件都能重跑。改一句旁白、换一张关键帧,只重跑那一段就够。14
三种输入的准备各不相同。一句话那条,你要说清语言、画幅与时长。
口播那条,你要交出视频文件,旁白时长由 ASR 的词级时间戳决定。照片那条,你要顺手写清服装与主体,否则每一拍都换衣服。5
主播模式交回的是两段素材拼起来的画面,单拍旁白要压到 9.5 秒以内。5

最短上手路径

第一步,把仓库克隆进技能目录:git clone https://github.com/Alisa0808/vox-director.git ~/.claude/skills/vox-director;也可以下载打包好的 vox-director.skill,从技能界面装。2
第二步,把 key 写进环境变量:export ATLASCLOUD_API_KEY="sk-..."。key 在 Atlas Cloud 控制台申请。215
第三步,验两样东西:command -v ffmpeg ffprobe 与 python3 -c "import PIL",缺哪样补哪样。5
第四步,对 Agent 说一句话,让它先出分镜表。官方给的例句是「做一支墨西哥街头美食的 Vox 拼贴片,英文,16:9,15 秒」。2
第五步,看分镜、挑画风,让它跑完剩下五个阶段。脚本会抽帧自检,你也可以把 final.mp4 拉出来自己看一遍。5
references/models-and-gotchas.md 的文件页:开头一张表列了七种活与报价,从关键帧 0.08 美元、动效 0.13 美元到配乐 0.11 美元;下面一节写着真人内容在 Omni 与 Seedance 上被拦,Kling 放行
这份 91 行的文档是整条流程的排障手册,价格、内容拦截、API 怪癖与 ffmpeg 的坑都收在同一页。2026-10-24 截图。3

会卡住的地方

只有 Atlas Cloud 一个后端。 症状:想换成自己的网关,配置里找不到可填的字段。触发条件:你要用别家的模型。现状:两条换后端的 PR 都还开着,一条加 Novita(8 月 11 日开),一条加 ModelRunner(9 月 10 日开),后者顺手指出各阶段的模型 ID 是写死的。1617 你能怎么办:等合并,或者照那条 PR 的思路自己补一层映射。
失败或卡住的任务会自动重投。 症状:账单上多出你没主动要求的第二次生成。触发条件:某一段生成超时或失败。现状:run_jobs() 现在会自动重提,把这条改掉的 PR #10 从 8 月 24 日开到现在。18 你能怎么办:批量跑之前盯住重提次数,或者先合并那条修复。
进阶路用的去背模型已经不在目录里。 症状:元素级动效那条路第一步就报模型不存在。触发条件:照文档写 youchuan/v8.1/remove-background。现状:今天的公开目录里查不到这个 ID,同类只剩 midjourney/v8.1/remove-background,报价 0.086 美元。319 你能怎么办:自己换 ID,换完重测抠图边缘。
真人或品牌标志会被拦。 症状:提交后被拒,提示内容违规。触发条件:画面里出现可识别的真人或商标。现状:Omni 与 Seedance 都拦,文档写换名字、转格式、去掉脸都没用;Kling 的 o3 pro 放行。3 你能怎么办:真人那条改 video_model,或者走不经过视频模型的本地关键帧。
画幅只有两种。 症状:写 1:1 或 3:4 时流程停下来问你。触发条件:用了 Omni 做动效。现状:Omni 只支持 16:9 与 9:16,脚本会挑最接近的比例再等你确认。20 你能怎么办:竖版就用 9:16,方形改换模型。
单镜头时长有下限。 症状:明明排了 2 秒,账单按 3 秒算。触发条件:镜头短于 3 秒。现状:Omni 的计费公式是 max(3, duration) × 0.13,时长本身允许 3 到 10 秒。20 你能怎么办:镜头排到 3 秒以上,用镜头数量拿节奏。
水印默认烧进画面。 症状:成片右下角始终有一行角标。触发条件:没在 beats.json 里改 watermark。现状:脚本里的常量是 Made with Atlas Cloud · vox-director,官方示例文件改成短版 Made with Atlas Cloud。13 你能怎么办:交付前先决定这行字留还是换。
字幕依赖 Pillow。 症状:字幕出不来,或者字体不对。触发条件:那台机器的 ffmpeg 没带 libass 与 drawtext。现状:作者机器就是这样,所以字幕与水印都先画成 PNG 再叠加。3 你能怎么办:补齐字体,或者换一个带完整滤镜的 ffmpeg。
装不到固定版本。 症状:今天能跑,明天报错。触发条件:你从主分支拉代码。现状:仓库 0 个 tag、0 个 release,安装说明就是 clone。1 你能怎么办:自己 fork 一份,锁住你验过的那次提交。
更新节奏慢。 症状:踩到的坑很久没人回。触发条件:撞上没人合并的 PR。现状:30 次提交,两位提交者(Alisa0808 28 次、kiana-liang 2 次),最后一次推送在 10 月 6 日凌晨。1 你能怎么办:把它当一份可以照抄的方法,先别当长期维护的产品。
成本自报与目录实价对不上。 症状:照文档做预算,跑完超支几倍。触发条件:一次连跑几条片。现状:文档写 30 秒片 0.8 到 1.0 美元,llms.txt 写 60 秒「几分钟、几美元」。321 你能怎么办:照下一节的算法自己算一遍。
旁白时长要从音频回推。 症状:字幕越走越偏。触发条件:按稿子字数排时间。现状:文档要求从 ASR 的词级时间戳取真实时长。3 你能怎么办:把 asr_beats.py 接在配音之后。
照片模式会换衣服。 症状:每一拍的服装都不一样。触发条件:没写 subject_wardrobe。现状:C-roll 的字段清单里专门有一项锁服装。5 你能怎么办:把服装具体到颜色与材质。
主播的背景板会漂。 症状:人物身后的世界每一拍变形。触发条件:主播拍次多、场景描述松。现状:文档写明会漂,建议重掷。5 你能怎么办:把背景元素逐个点名,掷到稳定为止。
风格比稿本身也花钱。 症状:还没出片就先付了几毛。触发条件:跑 3 到 4 个预设的比稿。现状:比稿的做法是用同一拍渲 3 到 4 张关键帧。5 你能怎么办:把它算进预算,一次比稿约 0.24 到 0.32 美元。
主题预设的数量两处不一致。 症状:照文档挑不到第十套。触发条件:按 SKILL.md 的九套清单挑。现状:styles.py 里有十套,多出来的是 gilded-deco。511 你能怎么办:以代码为准。
Pull requests 列表:Open 4、Closed 8,四条未合并的标题依次是加贡献指南、加 modelrunner 后端、防止重复计费提交、加 Novita 后端
四个开放的 PR 里有两条在补第二个模型后端,一条在处理重复计费。2026-10-24 截图。17

许可与真实成本

许可分两层。技能本体是 MIT,署名 Alisa Qian,改、卖、商用都行。22 模型那层各归各家:Google 的图与视频、xAI 的语音、MiniMax 的音乐、快手的 Kling、字节的 Seedance,各有各的条款与内容规则。
价目表在 Atlas Cloud 的公开目录里能查,不用登录。今天早上取到的数字是这样。19
环节模型目录价
关键帧 1kgoogle/nano-banana-2/text-to-image0.08 美元一张,2k 0.12、4k 0.1623
动效google/gemini-omni-flash/image-to-video0.13 美元一秒,最少 3 秒20
真人动效kwaivgi/kling-video-o3-pro/image-to-video0.095 美元,原价 0.112,按 85% 计;说明里没写单位24
旁白xai/tts-v1每千字符 0.015 美元25
配乐minimax/music-2.60.15 美元,仓库写 0.1119
音效与克隆bytedance/seed-audio-1.0每分钟 0.143 美元,仓库写 0.01519
一支 30 秒的片,按仓库自己的节奏排:6 拍,每拍一段 5 秒,关键帧 6 张,视频合计 30 秒。5
算下来:关键帧 0.48 美元,视频 3.90 美元,旁白按 400 字符算 0.006 美元,配乐 0.15 美元,合计约 4.54 美元。202325
把镜头拆细到最短 3 秒,30 秒要 10 个镜头:关键帧涨到 0.80 美元,视频仍是 3.90 美元,合计约 4.86 美元。
按同一套算法排一支 60 秒的片:12 段 5 秒的视频钱是 7.80 美元,关键帧 0.96 美元,合计约 9 美元。5
这一步在模型页上就能验:把时长拉到 5 秒,按钮写的就是 Run $0.65。4
Atlas Cloud 的 Gemini Omni Flash 图生视频页:左侧试跑面板里 Duration 拉到 5、Aspect Ratio 是 16:9,底部按钮写着 Run $0.65
5 秒一次要 0.65 美元,正好是 0.13 乘 5。按秒计费这件事,这一屏自己就说明了。2026-10-24 截图。4
仓库里那两处自报数字离这张表有点远。0.8 到 1.0 美元写在一份 91 行的参考文档末尾;llms.txt 说 60 秒的片「几分钟、几美元」,而按上一条算是 9 美元上下。321
差在哪,材料里有线索。那张表里的金额都是单次调用的量级,写的时候容易被当成「一段视频 0.13 美元」。模型页给的公式是 max(3, duration) × 0.13,单位是秒。20 两种读法差出五倍。
Seedance 更能说明单位这件事。目录标 0.09 美元,文档说它按 token 计费,720p 折下来约每秒 0.194 美元(促销价),原价 0.2429 美元。319 同一个数字,单位不同,结论差一倍以上。
主播拍次更贵:文档写每秒约是普通镜头的两倍。5 元素级那条进阶路也贵,约 1.5 美元,因为要跑十几次去背。3
还有一笔容易漏:失败重投。重投就是再付一次,直到 #10 合并为止。18
价格会变。Kling 与 Seedance 今天都挂在折扣位上,Kling 85%、Seedance 80%,促销一结束就回原价。19 动手前自己拉一次目录最稳。

和之前几期放在一起看

方案你给它什么它给你什么它在这一层许可与公开体量
vox-director一句选题、口播视频或一张照片,加一把 Atlas key一支拼贴解说片与可重跑的 beats.json画风与方法的技能包MIT,2,432 star,0 release1
video-shotcraft一句产品说明按镜头卡排出的产品片镜头资产库Apache-2.0,13,235 star9
claude-code-video-toolkit产品源码与一句需求十三个技能搭出的一间车间工作区MIT,2,318 star26
Mortiflix一句话,逐关审批分阶段产出,每关等你点头单人流水线AGPL-3.0,656 star27
onetake一句描述与分数验收一镜到底的产品动效片单一画风的技能非商业许可,3,102 star28
RemotionReact 组件逐帧渲染的 mp4渲染底座自订两层许可,66,709 star6
HyperFramesHTML浏览器逐帧拍成的 mp4渲染底座Apache-2.0,70,773 star7
OpenMontage编码 Agent 加一条产线Agent 编排出的成片产线框架AGPL-3.0,71,178 star29
hypit一条可重跑的工作流描述按 SVML 复现的片子工作流语言改过的 Apache-2.0,25,105 star30
星标与许可全部取 2026-10-24 早上。

今天该不该动手

该动手的条件:你要的是一批同一画风的解说片或广告片,三十秒一支、一天几条。你接受所有生成都走 Atlas Cloud。你算过一支 3 到 5 美元的账,这个数低于你自己搭这条链的时间成本。
先收藏的条件:你只需要一两支片,手工剪更快。你要接自己的模型端点。画面里会出现真人代言或品牌标志,得先把 Kling 那条路跑通。
跳过的条件:你要的是可继续编辑的多轨时间线,那是 BaoCut 与 Concat 那一类。8 你要长片,它的节奏按 30 到 60 秒设计。你要把成本压到接近零,这套每出一支都要真金白银。
安装是一条命令,试错成本在一支片。挑一个你熟悉的题目,先跑 15 秒版,把分镜与画风都看一遍,再决定要不要接进流水线。

References

  1. 1
    vox-director 仓库

    github.com

  2. 2
    README

    github.com

  3. 3
    models-and-gotchas.md

    github.com

  4. 4
    Gemini Omni Flash 图生视频模型页

    atlascloud.ai

  5. 5
    SKILL.md

    github.com

  6. 6
    remotion-dev/remotion

    github.com

  7. 7
    heygen-com/hyperframes

    github.com

  8. 8
    JimLiu/baocut

    github.com

  9. 9
    Vincentwei1021/video-shotcraft

    github.com

  10. 10
    prompt-guide.md

    github.com

  11. 11
    scripts/styles.py

    github.com

  12. 12
    beat-layer.md

    github.com

  13. 13
    scripts/assemble.py

    github.com

  14. 14
    AGENTS.md

    github.com

  15. 15
    Atlas Cloud API Keys

    atlascloud.ai

  16. 16
    PR #7 加 Novita 后端

    github.com

  17. 17
    PR #12 加 ModelRunner 后端

    github.com

  18. 18
    PR #10 防止重复计费提交

    github.com

  19. 19
    Atlas Cloud 模型目录接口

    api.atlascloud.ai

  20. 20
    Gemini Omni Flash 模型说明

    static.atlascloud.ai

  21. 21
    llms.txt

    github.com

  22. 22
    LICENSE

    github.com

  23. 23
    Nano Banana 2 模型说明

    static.atlascloud.ai

  24. 24
    Kling o3 Pro 模型说明

    static.atlascloud.ai

  25. 25
    xAI TTS v1 模型说明

    static.atlascloud.ai

  26. 26
    digitalsamba/claude-code-video-toolkit

    github.com

  27. 27
    GTKottman/mortiflix-oss

    github.com

  28. 28
    feitangyuan/onetake

    github.com

  29. 29
    calesthio/OpenMontage

    github.com

  30. 30
    hypit-ai/hypit

    github.com

每日一个 Agent 视频方案
每日一个 Agent 视频方案@Karuha

This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.

Related content

  • 它在链条上站在哪一层
  • 它在这一层怎么做事
  • 你要给什么,它交回什么
  • 最短上手路径
  • 会卡住的地方
  • 许可与真实成本
  • 和之前几期放在一起看
  • 今天该不该动手