VibeFrame：先报价再开机，30 秒片 10.63 美元，超上限连一拍都不跑，Veo 停用第二天它删了自带 Agent (2026)

装上 0.116.1 之后，我先让它给一支片子报价，再把允许花钱的上限写到 0.5 美元。

报价单是 0.78 美元，命令当场拒绝开工，把更便宜的走法连同被拒时依据的完整报价一起递了回来。这就是 VibeFrame 全部卖点里最实的一条：动手之前先报价，报价越过上限就不许花钱。

VibeFrame 是 vericontext 维护的 MIT 项目，一条 CLI 加一个 MCP 服务端，装在你的编码 Agent 旁边。CLI 的二进制叫 vibe。

它替 Agent 做三件事。一是调用 Seedance、Runway、Kling、Gemini Omni 这些前沿模型生成素材。

二是按模型目录价把整支片子的花费算出来。三是用一条硬上限拦住超支。项目官网把这句话写在首屏：让 Agent 生成视频，在一条它越不过去的花销线上。

下面按你决定要不要装它的顺序排。先看它站在链条的哪一层，再看要用它得准备什么、最短怎么跑通一遍。

中间是十五处实测撞到的阻塞，然后是 MIT 之外那几层许可与这笔钱的真实范围。最后一节给判断。

它在链条上站在哪一层

VibeFrame 站的是「生成」与「花钱」这一段，构图这一段它整段交给了别人。

README 的层级表写得很直接：React 组件式的程序化视频交给 Remotion，HTML 场景的确定性截帧交给 HyperFrames。

VibeFrame 自己管付费生成、预算闸、分镜与设计文件、构建报告、成片检查、编辑与重混。1 这两套底座前面都拆过，第 23 期是 Remotion，第 14 期是 HyperFrames。2 3

同一个边界还写进了路线图的「不打算做」一栏：不做以聊天界面为主体的产品，也不做替换 HyperFrames 的浏览器渲染器。4 工程的 vibe.config.json 里只有一个构图引擎可以填，就是 hyperframes。5

更值得记的是 0.116.0 这一版。它一次删掉四样东西：旧的三套 provider 方法、fal 这个旧别名、Veo（Google 已经停用），以及内建 Agent 和只服务于它的 LLM 适配器。6

删掉内建 Agent 之后，模型目录里写着一句定调的话：VibeFrame 自身不带 Agent 循环，由你的编码 Agent 或 MCP 宿主来驱动它。7

这一删把事情讲清楚了：它把自己定位成 Agent 手里的一把工具，编排权留在宿主那边。你的 Claude Code 或 Codex 负责想下一步，它负责执行、算钱、检查。

仓库首页（2026 年 10 月 26 日采集）：182 星、32 个 fork、1,180 次提交、216 个 tag，只有 main 一条分支，右侧许可证栏写 MIT。页面里的提交记录还能看到 0.116.0 前后那几条删除动作。

它在这一层怎么做事

一个工程就是几个 Markdown 文件。STORYBOARD.md 放标题、时长、画幅和人物表，scenes/ 下一场一个文件、按文件名顺序播放，DESIGN.md 放配色、字体、版式与动效。

media/ 放你自己的素材，assets/ 放生成出来的东西。5 它给出的理由很实用：分镜是给人改的，改一行字比在时间线上拖一下快。

每个场景文件的开头是十六个 cue 词，正文写导演提示。

duration 管节拍长度，narration 管配音文字，backdrop 与 keyframe 管静帧，video 管生成视频，provider 给这一拍单独换供应商，characters 引用人物表里定义好的角色。5 词表是封闭的：写错一个词，vibe storyboard validate 会警告，vibe storyboard set 会直接拒绝。5

算钱这件事分成两拍。vibe build --dry-run 不调用任何付费接口，也不需要一把 Key，它按模型目录的单价把整支片子拼成一张报价单。--max-cost 拿这张单子跟你的上限比，超了就以退出码 1 结束。1

被拒的报文带四样东西：错误码 COST_CAP_EXCEEDED、你的上限、这次估值、几条更便宜的补救命令。

这段设计对自动化流程有意义：Agent 循环读到一个结构化错误就会停下来，去猜的冲动被拿掉了。

跑起来之后，状态落在两份 JSON 里。build-report.json 回答这次构建产出了什么、花了多少、停在哪一阶段；review-report.json 回答哪里有问题、该谁修、用哪条命令修。5

报告里的 nextActions 已经分好类。safeToAutoRun 为真的直接跑，requiresConfirmation 为真的先问人。fixOwner 写 vibe 表示 CLI 自己能确定性地修，写 host-agent 表示要外层 Agent 改源文件。5

渲染之前还有一道闸。vibe build --stage sync 会把场景 HTML 过一遍 lint，有真错误就以非零码退出。带着错误直接渲染，出来是一段黑片。8

官网首屏（2026 年 10 月 26 日采集）。左侧演示的就是那道闸：--max-cost 3 对上 10.93 美元的报价，返回 COST_CAP_EXCEEDED 与两条补救命令；右侧把四个工程文件的角色并排放着，分镜、设计、构建报告、审阅报告各一格。

你要给什么，它交回什么

前置条件是三样：Node 20 以上、FFmpeg、Chrome 或 Chromium。1 我在这台机器上跑 vibe doctor，Node 22.13.1 与 FFmpeg 7.1.5 都通过。它顺手报出 FFmpeg 里 drawtext、subtitles、afftdn 三个滤镜可用，并指出配置文件 ~/.vibeframe/config.yaml 这时还没生成。

Key 按供应商分开配。Seedance 要 FAL_API_KEY，Grok 要 XAI_API_KEY，Kling 要 KLING_API_KEY，Omni 要 GOOGLE_API_KEY，Runway 要 RUNWAY_API_SECRET，配音要 ELEVENLABS_API_KEY 或 OPENAI_API_KEY。7 项目把这些加起来称为 13 家第三方 AI 服务。9 图生视频还要多一把 IMGBB_API_KEY，原因见下面第 4 条。

它交回四样东西：一支 MP4（也可以选 WebM 或 MOV）、上面那两份报告加一份 render-report.json、一套能继续改的 STORYBOARD.md 工程、以及给下一个 Agent 读的 vibe context 说明。

命令面比我预想的大。vibe schema --list 在我这里列出 93 条命令：49 条标成免费、19 条低花费、8 条高花费、3 条极高，另有 14 条没标价档。

官网另说 MCP 面上有 77 个工具。10 这套量级说明一件事：它给自己划的地盘是整条生成流水线，从一句 brief 到抽帧检查都在里面。

最短上手路径

第一步，装。文档给的是 curl -fsSL https://vibeframe.ai/install.sh | bash。我用 npm 装 @vibeframe/cli，182 个包，20 秒装完，vibe --version 输出 0.116.1。11

第二步，建工程。vibe init launch --from "30-second launch video for a CLI that gives coding agents a video budget" --json 用了 28 毫秒，生成 11 个文件，默认 profile 是 agent，类型 cinema，画幅 16:9。

第三步，报价。此刻的 STORYBOARD.md 里 duration 写的是 10，三个场景合计 10 秒，vibe build launch --dry-run --json 给出 0.78 美元。它同时警告：三张背景图按每张 0.211 美元算，约 0.60 美元。想省就加 --skip-backdrop，让画面由 HTML 与 CSS 画出来。7

第四步，把片子改成你要的长度。我把 duration 改成 30，把场景拆成六个五秒的节拍，每拍加一句 keyframe 与一句 video，再报一次价：10.63 美元。同一份工程加 --skip-video --skip-keyframe 再报一次，0.37 美元。

第五步，设上限开跑。vibe build launch --dry-run --max-cost 0.5 被拒，报文原文是 Estimated cost $0.78 exceeds --max-cost $0.50.，retryWith 里给了三条更便宜的走法。把上限放到 12 美元以上，它就会真的去调 Seedance 与图片模型。

零 Key 也能跑半程。我跑 vibe build launch --tts kokoro --skip-backdrop --json，结果停在 status: needs-author、currentStage: compose、花费 0。三个节拍的素材都就位，场景 HTML 一份没写。8 这就是文档说的分工：构图那半段归你的 Agent，它负责把进度和下一步命令整理好交回去。

项目官网的展示片画面（1280×720）：一位摄影师在极夜里，同一角色跨四个场景。画面与人物一致性由项目官网自己发布，按 README 的说法整支片由 `vibe build` 端到端生成。

会卡住的地方

1. brief 里写的时长没人读。

症状：--from 里写着 30 秒，生成出来的工程是 10 秒三拍。
触发条件：任何一次 vibe init --from。
现状：我实测的 STORYBOARD.md 里 duration: 10，三个场景是 3.3、3.3、3.4 秒（2026-10-26，v0.116.1）。
你能怎么办：init 完先手改 duration 与每个场景的 duration，再报价，免得第一张单子算错。

2. 报价是目录价的上限，账单会另算。

症状：dry-run 的钱数跟供应商账单对不上。
触发条件：任何一次付费生成。
现状：MODELS.md 自己写明「Prices are upper-bound list prices for estimates, not metered billing」，价格用来估算，不用于结算。7
你能怎么办：把报价当上限用，对账看 build-report.json 里的 costUsd，那里记的是实际花掉的钱。5

3. Seedance 拒收带人脸的关键帧。

症状：图生视频这一步返回 HTTP 422。
触发条件：关键帧里人脸清晰可见，包括 AI 生成的写实人脸。
现状：MODELS.md 记这条政策来自字节的平台规则，fal.ai 只是转发；重试无效，手部或背影的镜头能过。该条目注明观察于 2026-07-26。7
你能怎么办：配好 RUNWAY_API_SECRET 让它自动回落到 Runway，或在那一拍的 cue 里写 provider: runway。

4. 本地关键帧要先传到第三方图床。

症状：图生视频报缺少 URL。
触发条件：用 Seedance 或 Kling 做图生视频，这两家只收 URL。
现状：MODELS.md 写它会自动经 ImgBB 上传本地图片，所以要另配 IMGBB_API_KEY。7
你能怎么办：素材敏感就别走图生视频这条路；或者自己把关键帧放到可公网访问的地址，直接把 URL 交给它。

5. 它自己不会规划下一步。

症状：你想让它像 Agent 一样自己决定重做哪一拍，找不到入口。
触发条件：期待它内置一个自主循环。
现状：0.116.0 的破例清单里有一条「移掉内建 Agent 与只有它在用的 LLM 适配器」，模型目录也写明它自身不带 Agent 循环。6 7
你能怎么办：循环交给宿主 Agent，状态读 vibe context、build-report.json、review-report.json 三样。

发布列表（2026 年 10 月 26 日采集）：最新一版 v0.116.1 修了三处，前一版 v0.116.0 的 Breaking 段落就在下面，四条破坏性改动里包括删掉内建 Agent 与删掉 Veo。

6. Veo 3.1 在 10 月 22 日停用了。

症状：旧工程里写 video: veo 或命令行加 -p veo，报错并指向别的模型。
触发条件：沿用上半年写的工程或脚本。
现状：Google 的停用清单把 veo-3.1-generate-preview 等三个型号的关停日定在 2026 年 10 月 22 日，推荐替代是 gemini-omni-1.1-flash。12 VibeFrame 在 0.116.0 里删掉 Veo，并停止自动换成别家供应商。6
你能怎么办：把 veo 改成 omni，或者给那一拍 pin 一个供应商，别让它替你猜。

7. 模型目录自己在漂。

症状：照抄半年前文档里的模型 ID，请求被拒。
触发条件：直接用具体型号 ID，不用别名。
现状：MODELS.md 的 Status 栏里，Gemini 3.5 Flash 在 2026-10-08 被弃用，GPT Image 1.5 定在 2026-12-01 关停，Whisper 定在 2027-02-26 关停，Gemini 2.5 系自 2026-09-18 起新项目不能用。7
你能怎么办：catalog 里每个系列都留了别名（flash、2.5、fast），优先用别名，让项目自己去跟新版本。

8. npx vibeframe 会装到另一个包。

症状：装完跑起来发现是另一个不相干的项目。
触发条件：按仓库名直接 npx。
现状：README 明说裸名 vibeframe 属于另一个无关的包，本项目的包名是 @vibeframe/cli，二进制叫 vibe。1
你能怎么办：按文档的包名装，或者走 install.sh。

9. 场景没过 lint 就渲染，出来是黑片。

症状：渲染成功了，打开一片黑。
触发条件：漏掉 --stage sync，或对它报的错置之不理。
现状：docs/hyperframes.md 写得很直白：带着 lint 错误渲染会得到一段黑色的 MP4。常见错误包括没注册的 GSAP 时间线、缺少 data-width / data-height 的容器。8
你能怎么办：把 --stage sync 当成硬闸，非零退出就不往下走。

10. 零 Key 那条路走不到成片。

症状：以为不花钱也能出一支片，结果停在半路。
触发条件：一把 Key 都没配的时候。
现状：我实测停在 needs-author，三个节拍的素材就位、场景 HTML 一份没写，花费 0。8
你能怎么办：让宿主 Agent 按 vibe scene compose-prompts 的提示写场景 HTML，或先用 vibe scene add 生成一个模板场景把链路跑通。

11. 免费音色只有英文。

症状：中文口播念不出来，或者音色明显不对。
触发条件：用 Kokoro 这条本地免费配音。
现状：MODELS.md 的 Kokoro 行注明只支持英文音色，中文要走 ElevenLabs 或 OpenAI TTS。7
你能怎么办：中文片一开始就把付费 TTS 算进报价，别等成片了才发现。

12. 那条免费配乐不能商用。

症状：用 Replicate 出背景音乐，商用前被许可卡住。
触发条件：vibe generate music -p replicate。
现状：MODELS.md 的音频表注明 MusicGen 权重是 CC-BY-NC，不能商用。7
你能怎么办：商用改走 ElevenLabs Music，它是按分钟计价的付费项。

13. 团队到四个人，动效那条命令要多付一笔。

症状：vibe generate motion 用起来没问题，年底法务来找。
触发条件：这条命令会 shell 出去跑 npx remotion，产物是 Remotion 工程。
现状：CREDITS.md 记了这层依赖。9 Remotion 的价格页写明个人与三人以内的公司免费；四人以上要么按每渲染 0.01 美元、每月最低 100 美元，要么按每席位每月 25 美元；企业版自每月 500 美元起。13
你能怎么办：用这条命令前先确认公司规模落在哪一档。

14. 一个人维护，七个月 216 个 tag。

症状：接口说变就变，升级容易踩空。
触发条件：不钉版本，跟着 main 走。
现状：仓库首页显示 1,180 次提交、216 个 tag、一条分支。贡献者接口给出 5 个账号，其中 kiyeonjeon21 一个人 1,173 次。1 npm 上 161 个版本，最早一个发布于 2026-03-28；51 条问题单全部关闭，0 条开放。11
你能怎么办：把版本钉死，升级前读 CHANGELOG 的 Breaking 段。

15. 用它的人还很少。

症状：遇到问题搜不到答案。
触发条件：指望社区文章与现成解答。
现状：npm 上周下载 737 次（2026-10-16 至 10-22），GitHub 182 星、32 个 fork。1 11
你能怎么办：默认自己是早期用户，答案从 vibe context、vibe schema --list 和两份报告里自己读。

许可与真实成本

本体是 MIT，仓库许可栏与 LICENSE 文件一致。1 压在上面的三层要看清楚：

构图底座：HyperFrames 是 Apache-2.0，VibeFrame 只调用它的 npm 包。9
动效那条命令：调 npx remotion，落到 Remotion 自己的两层授权，四人以上公司要付。9 13
素材与音色：Kokoro 是 Apache-2.0 的本地模型；Replicate 的 MusicGen 权重是 CC-BY-NC，不能商用。7

成本这块，模型目录把所有单价摊在一张表上，而且它自己说这是上限估值。7

MODELS.md 的模型目录页（2026 年 10 月 26 日采集）。表头的说明句是关键：这些是用于估算的上限目录价，不用于结算；同一页往下还有图片、视频、语音、音乐四张表。

同一支 30 秒片，换个供应商，钱能差十倍。下表按目录价换算，30 秒按整段生成算：

视频供应商与型号	目录单价（每秒）	30 秒合计	备注
Seedance 2.0（默认）	0.3034 美元	9.10 美元	4–15 秒一段，自带声音
Seedance 2.0 Fast	0.2419 美元	7.26 美元	4–15 秒，最高 720p
Runway Gen-4.5	0.12 美元	3.60 美元	2–10 秒一段，无声音
Gemini Omni 1.1 Flash	0.10 美元	3.00 美元	3–10 秒，时长由模型定
Kling v3	0.084 美元	2.52 美元	3–15 秒，标准档 720p 无声
Grok Imagine Video 1.5 Lite	0.03 美元	0.90 美元	1–15 秒，自带声音

来源同一条：VibeFrame 的模型目录价。7 其中 Omni 那一档跟 Google 自己的价格页对得上：720p 输出按每百万 token 17.50 美元、每秒 5,792 个 token 折算，约每秒 0.10 美元。14

关键帧的钱也差得开。同样六张：GPT Image 2.5 每张 0.211 美元，六张 1.27 美元；Nano Banana 2.1 每张 0.0336 美元，六张 0.20 美元；Grok Imagine 每张 0.02 美元，六张 0.12 美元。7

这些数字拼起来，就是我实测那两笔钱的来源。六个五秒镜头按默认 Seedance 2.0 是 9.10 美元，六张 GPT Image 关键帧是 1.27 美元，两项合计 10.37 美元。

报价 10.63 美元，差额落在文本调用与取整口径上。换成 Grok 那两个便宜档，同一支片子约 1.02 美元。

上限闸拦的是这些调用，它按次计价，不按时间或磁盘计费。

和之前几期放在一起看

方案	你给它什么	它给你什么	它在这一层	许可与公开体量
VibeFrame（本期）	一句 brief、分镜 Markdown、各家 Key、一条花销上限	生成素材、报价单、拦截报文、两份报告、MP4	付费生成与预算闸，构图交给 HyperFrames	MIT，182 星，单个维护者
Remotion	React 组件与工程	逐帧确定性渲染	渲染底座	自订两层，67,427 星 2
HyperFrames	HTML 场景与浏览器	截帧成 mp4	渲染底座	Apache-2.0，71,697 星 3
vox-director	一句选题	纸片拼贴解说片	画风与技能包，单一后端	MIT，2,452 星 15
claude-code-video-toolkit	产品源码与品牌参数	重画界面的成片与素材	技能包与工具集	MIT，2,340 星 16
Frametell	一句选题，签分镜	逐页代码画的解说片	方法论与本地工程	AGPL-3.0，402 星 17
OpenMontage	12 条产线与编码 Agent	多段成片与产线报告	编排方法论，产线用 JSON 描述	AGPL-3.0，71,876 星 18
onetake	一句选题与一份风格档	一镜到底的产品动效片	画风与验收脚本	PolyForm NC，3,245 星 19
ManimGX	Python 脚本	数学与 3D 动画	渲染底座	MIT，2,128 星 20

放进这张表，VibeFrame 的独特处只有一条：它把「花多少钱」做成一条能拦人的命令。

前几期里，Mortiflix 是本人在每道关点头，BaoCut 是把每笔改动做成事务留回执，VibeFrame 是把钱做成阈值留报文。三种做法里，最后这种最适合接在无人值守的流水线上。

今天该不该动手

今天就动手，如果你已经把视频接进了自己的 Agent 循环，手里有一到两家供应商的 Key，并且需要一条能让流水线自己停下来的钱线。

它在这一层的活儿干得很干脆：报价排在花钱之前，拒绝以结构化报文返回，报告里写清了下一步该谁修。

先收藏，如果你要的只是用 HTML 场景拼一支片子，那条路直接用 HyperFrames 更省事，项目自己也这么建议。

跳过，如果你要的是一个自己会规划、会重试、会决定下一步做什么的 Agent。它在 0.116.0 里把这一层删了，安排能力留在宿主那边。6

References

1
vericontext/vibeframe
github.com
2
remotion-dev/remotion
github.com
3
heygen-com/hyperframes
github.com
4
VibeFrame 路线图
github.com
5
VibeFrame 工程文件与流程
github.com
6
VibeFrame 变更记录
github.com
7
VibeFrame 模型目录 MODELS.md
github.com
8
VibeFrame 构图引擎边界
github.com
9
VibeFrame 依赖来源 CREDITS.md
github.com
10
VibeFrame 官网
vibeframe.ai
11
@vibeframe/cli 在 npm
npmjs.com
12
Gemini API 模型停用清单
ai.google.dev
13
Remotion 授权与价格
remotion.dev
14
Gemini Developer API 价格
ai.google.dev
15
Alisa0808/vox-director
github.com
16
digitalsamba/claude-code-video-toolkit
github.com
17
sitor-ai/frametell
github.com
18
calesthio/OpenMontage
github.com
19
feitangyuan/onetake
github.com
20
academa-labs/manimgx
github.com

装上 0.116.1 之后，我先让它给一支片子报价，再把允许花钱的上限写到 0.5 美元。

VibeFrame 是 vericontext 维护的 MIT 项目，一条 CLI 加一个 MCP 服务端，装在你的编码 Agent 旁边。CLI 的二进制叫 vibe。

它替 Agent 做三件事。一是调用 Seedance、Runway、Kling、Gemini Omni 这些前沿模型生成素材。

下面按你决定要不要装它的顺序排。先看它站在链条的哪一层，再看要用它得准备什么、最短怎么跑通一遍。

中间是十五处实测撞到的阻塞，然后是 MIT 之外那几层许可与这笔钱的真实范围。最后一节给判断。

它在链条上站在哪一层

VibeFrame 站的是「生成」与「花钱」这一段，构图这一段它整段交给了别人。

README 的层级表写得很直接：React 组件式的程序化视频交给 Remotion，HTML 场景的确定性截帧交给 HyperFrames。

删掉内建 Agent 之后，模型目录里写着一句定调的话：VibeFrame 自身不带 Agent 循环，由你的编码 Agent 或 MCP 宿主来驱动它。7

它在这一层怎么做事

media/ 放你自己的素材，assets/ 放生成出来的东西。5 它给出的理由很实用：分镜是给人改的，改一行字比在时间线上拖一下快。

每个场景文件的开头是十六个 cue 词，正文写导演提示。

被拒的报文带四样东西：错误码 COST_CAP_EXCEEDED、你的上限、这次估值、几条更便宜的补救命令。

这段设计对自动化流程有意义：Agent 循环读到一个结构化错误就会停下来，去猜的冲动被拿掉了。

渲染之前还有一道闸。vibe build --stage sync 会把场景 HTML 过一遍 lint，有真错误就以非零码退出。带着错误直接渲染，出来是一段黑片。8

你要给什么，它交回什么

命令面比我预想的大。vibe schema --list 在我这里列出 93 条命令：49 条标成免费、19 条低花费、8 条高花费、3 条极高，另有 14 条没标价档。

官网另说 MCP 面上有 77 个工具。10 这套量级说明一件事：它给自己划的地盘是整条生成流水线，从一句 brief 到抽帧检查都在里面。

最短上手路径

第一步，装。文档给的是 curl -fsSL https://vibeframe.ai/install.sh | bash。我用 npm 装 @vibeframe/cli，182 个包，20 秒装完，vibe --version 输出 0.116.1。11

会卡住的地方

1. brief 里写的时长没人读。

症状：--from 里写着 30 秒，生成出来的工程是 10 秒三拍。
触发条件：任何一次 vibe init --from。
现状：我实测的 STORYBOARD.md 里 duration: 10，三个场景是 3.3、3.3、3.4 秒（2026-10-26，v0.116.1）。
你能怎么办：init 完先手改 duration 与每个场景的 duration，再报价，免得第一张单子算错。

2. 报价是目录价的上限，账单会另算。

症状：dry-run 的钱数跟供应商账单对不上。
触发条件：任何一次付费生成。
现状：MODELS.md 自己写明「Prices are upper-bound list prices for estimates, not metered billing」，价格用来估算，不用于结算。7
你能怎么办：把报价当上限用，对账看 build-report.json 里的 costUsd，那里记的是实际花掉的钱。5

3. Seedance 拒收带人脸的关键帧。

症状：图生视频这一步返回 HTTP 422。
触发条件：关键帧里人脸清晰可见，包括 AI 生成的写实人脸。
现状：MODELS.md 记这条政策来自字节的平台规则，fal.ai 只是转发；重试无效，手部或背影的镜头能过。该条目注明观察于 2026-07-26。7
你能怎么办：配好 RUNWAY_API_SECRET 让它自动回落到 Runway，或在那一拍的 cue 里写 provider: runway。

4. 本地关键帧要先传到第三方图床。

症状：图生视频报缺少 URL。
触发条件：用 Seedance 或 Kling 做图生视频，这两家只收 URL。
现状：MODELS.md 写它会自动经 ImgBB 上传本地图片，所以要另配 IMGBB_API_KEY。7
你能怎么办：素材敏感就别走图生视频这条路；或者自己把关键帧放到可公网访问的地址，直接把 URL 交给它。

5. 它自己不会规划下一步。

症状：你想让它像 Agent 一样自己决定重做哪一拍，找不到入口。
触发条件：期待它内置一个自主循环。
现状：0.116.0 的破例清单里有一条「移掉内建 Agent 与只有它在用的 LLM 适配器」，模型目录也写明它自身不带 Agent 循环。6 7
你能怎么办：循环交给宿主 Agent，状态读 vibe context、build-report.json、review-report.json 三样。

6. Veo 3.1 在 10 月 22 日停用了。

症状：旧工程里写 video: veo 或命令行加 -p veo，报错并指向别的模型。
触发条件：沿用上半年写的工程或脚本。
现状：Google 的停用清单把 veo-3.1-generate-preview 等三个型号的关停日定在 2026 年 10 月 22 日，推荐替代是 gemini-omni-1.1-flash。12 VibeFrame 在 0.116.0 里删掉 Veo，并停止自动换成别家供应商。6
你能怎么办：把 veo 改成 omni，或者给那一拍 pin 一个供应商，别让它替你猜。

7. 模型目录自己在漂。

症状：照抄半年前文档里的模型 ID，请求被拒。
触发条件：直接用具体型号 ID，不用别名。
现状：MODELS.md 的 Status 栏里，Gemini 3.5 Flash 在 2026-10-08 被弃用，GPT Image 1.5 定在 2026-12-01 关停，Whisper 定在 2027-02-26 关停，Gemini 2.5 系自 2026-09-18 起新项目不能用。7
你能怎么办：catalog 里每个系列都留了别名（flash、2.5、fast），优先用别名，让项目自己去跟新版本。

8. npx vibeframe 会装到另一个包。

症状：装完跑起来发现是另一个不相干的项目。
触发条件：按仓库名直接 npx。
现状：README 明说裸名 vibeframe 属于另一个无关的包，本项目的包名是 @vibeframe/cli，二进制叫 vibe。1
你能怎么办：按文档的包名装，或者走 install.sh。

9. 场景没过 lint 就渲染，出来是黑片。

症状：渲染成功了，打开一片黑。
触发条件：漏掉 --stage sync，或对它报的错置之不理。
现状：docs/hyperframes.md 写得很直白：带着 lint 错误渲染会得到一段黑色的 MP4。常见错误包括没注册的 GSAP 时间线、缺少 data-width / data-height 的容器。8
你能怎么办：把 --stage sync 当成硬闸，非零退出就不往下走。

10. 零 Key 那条路走不到成片。

症状：以为不花钱也能出一支片，结果停在半路。
触发条件：一把 Key 都没配的时候。
现状：我实测停在 needs-author，三个节拍的素材就位、场景 HTML 一份没写，花费 0。8
你能怎么办：让宿主 Agent 按 vibe scene compose-prompts 的提示写场景 HTML，或先用 vibe scene add 生成一个模板场景把链路跑通。

11. 免费音色只有英文。

症状：中文口播念不出来，或者音色明显不对。
触发条件：用 Kokoro 这条本地免费配音。
现状：MODELS.md 的 Kokoro 行注明只支持英文音色，中文要走 ElevenLabs 或 OpenAI TTS。7
你能怎么办：中文片一开始就把付费 TTS 算进报价，别等成片了才发现。

12. 那条免费配乐不能商用。

症状：用 Replicate 出背景音乐，商用前被许可卡住。
触发条件：vibe generate music -p replicate。
现状：MODELS.md 的音频表注明 MusicGen 权重是 CC-BY-NC，不能商用。7
你能怎么办：商用改走 ElevenLabs Music，它是按分钟计价的付费项。

13. 团队到四个人，动效那条命令要多付一笔。

症状：vibe generate motion 用起来没问题，年底法务来找。
触发条件：这条命令会 shell 出去跑 npx remotion，产物是 Remotion 工程。
现状：CREDITS.md 记了这层依赖。9 Remotion 的价格页写明个人与三人以内的公司免费；四人以上要么按每渲染 0.01 美元、每月最低 100 美元，要么按每席位每月 25 美元；企业版自每月 500 美元起。13
你能怎么办：用这条命令前先确认公司规模落在哪一档。

14. 一个人维护，七个月 216 个 tag。

症状：接口说变就变，升级容易踩空。
触发条件：不钉版本，跟着 main 走。
现状：仓库首页显示 1,180 次提交、216 个 tag、一条分支。贡献者接口给出 5 个账号，其中 kiyeonjeon21 一个人 1,173 次。1 npm 上 161 个版本，最早一个发布于 2026-03-28；51 条问题单全部关闭，0 条开放。11
你能怎么办：把版本钉死，升级前读 CHANGELOG 的 Breaking 段。

15. 用它的人还很少。

症状：遇到问题搜不到答案。
触发条件：指望社区文章与现成解答。
现状：npm 上周下载 737 次（2026-10-16 至 10-22），GitHub 182 星、32 个 fork。1 11
你能怎么办：默认自己是早期用户，答案从 vibe context、vibe schema --list 和两份报告里自己读。

许可与真实成本

本体是 MIT，仓库许可栏与 LICENSE 文件一致。1 压在上面的三层要看清楚：

构图底座：HyperFrames 是 Apache-2.0，VibeFrame 只调用它的 npm 包。9
动效那条命令：调 npx remotion，落到 Remotion 自己的两层授权，四人以上公司要付。9 13
素材与音色：Kokoro 是 Apache-2.0 的本地模型；Replicate 的 MusicGen 权重是 CC-BY-NC，不能商用。7

成本这块，模型目录把所有单价摊在一张表上，而且它自己说这是上限估值。7

同一支 30 秒片，换个供应商，钱能差十倍。下表按目录价换算，30 秒按整段生成算：

视频供应商与型号	目录单价（每秒）	30 秒合计	备注
Seedance 2.0（默认）	0.3034 美元	9.10 美元	4–15 秒一段，自带声音
Seedance 2.0 Fast	0.2419 美元	7.26 美元	4–15 秒，最高 720p
Runway Gen-4.5	0.12 美元	3.60 美元	2–10 秒一段，无声音
Gemini Omni 1.1 Flash	0.10 美元	3.00 美元	3–10 秒，时长由模型定
Kling v3	0.084 美元	2.52 美元	3–15 秒，标准档 720p 无声
Grok Imagine Video 1.5 Lite	0.03 美元	0.90 美元	1–15 秒，自带声音

这些数字拼起来，就是我实测那两笔钱的来源。六个五秒镜头按默认 Seedance 2.0 是 9.10 美元，六张 GPT Image 关键帧是 1.27 美元，两项合计 10.37 美元。

报价 10.63 美元，差额落在文本调用与取整口径上。换成 Grok 那两个便宜档，同一支片子约 1.02 美元。

上限闸拦的是这些调用，它按次计价，不按时间或磁盘计费。

和之前几期放在一起看

方案	你给它什么	它给你什么	它在这一层	许可与公开体量
VibeFrame（本期）	一句 brief、分镜 Markdown、各家 Key、一条花销上限	生成素材、报价单、拦截报文、两份报告、MP4	付费生成与预算闸，构图交给 HyperFrames	MIT，182 星，单个维护者
Remotion	React 组件与工程	逐帧确定性渲染	渲染底座	自订两层，67,427 星 2
HyperFrames	HTML 场景与浏览器	截帧成 mp4	渲染底座	Apache-2.0，71,697 星 3
vox-director	一句选题	纸片拼贴解说片	画风与技能包，单一后端	MIT，2,452 星 15
claude-code-video-toolkit	产品源码与品牌参数	重画界面的成片与素材	技能包与工具集	MIT，2,340 星 16
Frametell	一句选题，签分镜	逐页代码画的解说片	方法论与本地工程	AGPL-3.0，402 星 17
OpenMontage	12 条产线与编码 Agent	多段成片与产线报告	编排方法论，产线用 JSON 描述	AGPL-3.0，71,876 星 18
onetake	一句选题与一份风格档	一镜到底的产品动效片	画风与验收脚本	PolyForm NC，3,245 星 19
ManimGX	Python 脚本	数学与 3D 动画	渲染底座	MIT，2,128 星 20

放进这张表，VibeFrame 的独特处只有一条：它把「花多少钱」做成一条能拦人的命令。

今天该不该动手

今天就动手，如果你已经把视频接进了自己的 Agent 循环，手里有一到两家供应商的 Key，并且需要一条能让流水线自己停下来的钱线。

它在这一层的活儿干得很干脆：报价排在花钱之前，拒绝以结构化报文返回，报告里写清了下一步该谁修。

先收藏，如果你要的只是用 HTML 场景拼一支片子，那条路直接用 HyperFrames 更省事，项目自己也这么建议。

跳过，如果你要的是一个自己会规划、会重试、会决定下一步做什么的 Agent。它在 0.116.0 里把这一层删了，安排能力留在宿主那边。6

References

1
vericontext/vibeframe
github.com
2
remotion-dev/remotion
github.com
3
heygen-com/hyperframes
github.com
4
VibeFrame 路线图
github.com
5
VibeFrame 工程文件与流程
github.com
6
VibeFrame 变更记录
github.com
7
VibeFrame 模型目录 MODELS.md
github.com
8
VibeFrame 构图引擎边界
github.com
9
VibeFrame 依赖来源 CREDITS.md
github.com
10
VibeFrame 官网
vibeframe.ai
11
@vibeframe/cli 在 npm
npmjs.com
12
Gemini API 模型停用清单
ai.google.dev
13
Remotion 授权与价格
remotion.dev
14
Gemini Developer API 价格
ai.google.dev
15
Alisa0808/vox-director
github.com
16
digitalsamba/claude-code-video-toolkit
github.com
17
sitor-ai/frametell
github.com
18
calesthio/OpenMontage
github.com
19
feitangyuan/onetake
github.com
20
academa-labs/manimgx
github.com

VibeFrame：先报价再开机，30 秒片 10.63 美元，超上限连一拍都不跑，Veo 停用第二天它删了自带 Agent

它在链条上站在哪一层

它在这一层怎么做事

你要给什么，它交回什么

最短上手路径

会卡住的地方

许可与真实成本

和之前几期放在一起看

今天该不该动手

References

Related content

VibeFrame：先报价再开机，30 秒片 10.63 美元，超上限连一拍都不跑，Veo 停用第二天它删了自带 Agent

它在链条上站在哪一层

它在这一层怎么做事

你要给什么，它交回什么

最短上手路径

会卡住的地方

许可与真实成本

和之前几期放在一起看

今天该不该动手

References

Related content