本地 API · 开放接口
RiffCut 影创把内核能力通过本地 API、MCP 协议与 timeline 工程格式开放出来。你可以用熟悉的方式驱动它,也可以直接编辑工程文件——一切都在本机完成。
内核协议
内核 kernel.js 以 stdio JSON-RPC 方式与主程序通信,握手名 deepseek-harness-sdk-runtime,初始化超时 60 秒。
initialize、session.prompt、session.resume、session.wait、shutdown——支持续接上次会话,长任务不用从头来。
session.event、subagent.started、subagent.finished 等事件实时回传,界面能跟上内核在做什么。
kernelchat.js 全局单实例、用 DSH_HOME 做环境隔离,调用记账统一挂在 RiffCut 名下。
工程格式
工程默认 1920×1080、30fps、10 秒,画面被拆成四条轨道,坐标与时长都用比例表示。
| 轨道 | 用途 | 说明 |
|---|---|---|
v1 | 视频 | 主画面素材轨 |
g1 | 图形 | 图形、贴图、画中画 |
t1 | 字幕 | 对白与说明字幕 |
a1 | 音频 | 对白、音效、配乐、底噪 |
坐标约定:`x` / `y` 是相对画布中心的 0–1 比例,`w` / `h` 是占画布的比例,`at` 是片段内进度 0–1。层序为 video 1 / layer 2 / text 3。
渲染管线
渲染走本地 hyperframes,不是联网服务;失败可查日志、自动重试。
| 项目 | 值 | 说明 |
|---|---|---|
| 渲染器 | 本地 hyperframes | 显式指定 FFmpeg / FFprobe 路径 |
| 缓存 | 成功 5 分钟 / 失败 30 秒 | ready 状态缓存 |
| 超时 | 3,600,000 ms | 单工程最长 1 小时 |
| 重试 | 2 次 | flaky 失败自动重试 |
| 失败日志 | /tmp/hf_render_fail.log | 排查渲染问题的第一现场 |
MCP
RiffCut 暴露名为 velora-video 的 MCP 服务,任何支持 MCP 的客户端都能接。
| 项目 | 值 |
|---|---|
| 服务名 | velora-video |
| 协议版本 | 2024-11-05 |
| 传输 | stdio JSON-RPC 2.0 |
| 工具前缀 | mcp__velora-video__ |
发布驱动覆盖抖音、小红书、快手、视频号、B站 5 个平台,CDP 端口默认 9333,可用环境变量 `RiffCut_CDP_PORT` 覆盖。默认 dry-run 只填不点。