首页/RiffCut 影创/本地 API免费下载

本地 API · 开放接口

本地开放,接进你自己的工作流

RiffCut 影创把内核能力通过本地 API、MCP 协议与 timeline 工程格式开放出来。你可以用熟悉的方式驱动它,也可以直接编辑工程文件——一切都在本机完成。

stdio JSON-RPCMCP 2024-11-05timeline.json本地 IPC
内核是独立的 JSON-RPC 进程会话、子代理、事件都走标准协议
4工程轨道
5IPC 驱动平台
28主进程 IPC 通道
1h渲染超时上限

内核协议

stdio JSON-RPC,会话可续

内核 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 名下。

工程格式

timeline.json:一条片子的四轨结构

工程默认 1920×1080、30fps、10 秒,画面被拆成四条轨道,坐标与时长都用比例表示。

轨道用途说明
v1视频主画面素材轨
g1图形图形、贴图、画中画
t1字幕对白与说明字幕
a1音频对白、音效、配乐、底噪

坐标约定:`x` / `y` 是相对画布中心的 0–1 比例,`w` / `h` 是占画布的比例,`at` 是片段内进度 0–1。层序为 video 1 / layer 2 / text 3。

渲染管线

从 timeline 到 MP4

渲染走本地 hyperframes,不是联网服务;失败可查日志、自动重试。

项目值说明
渲染器本地 hyperframes显式指定 FFmpeg / FFprobe 路径
缓存成功 5 分钟 / 失败 30 秒ready 状态缓存
超时3,600,000 ms单工程最长 1 小时
重试2 次flaky 失败自动重试
失败日志/tmp/hf_render_fail.log排查渲染问题的第一现场

MCP

作为 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 只填不点。

把 RiffCut 接进你的工作流

本地 API + MCP + 开放工程格式,能力都在本机。