Rilo 将故事转化为成品视频——AI 生成脚本、配音、关键帧和合成，一条命令完成。

用纯文本写下您的故事。Rilo 处理剩下的部分：脚本生成、旁白配音、视觉关键帧、视频片段和最终合成——以及可选的字幕对齐与烧录。

专为需要大规模、可复现、高质量视频生产而无需手动编辑的创作者和团队打造。

功能特性

• 完整流水线，一条命令 — 故事 → 脚本 → 配音 → 关键帧 → 片段 → 最终视频。rilo --project demo --story-file ./story.txt
• 检查点运行 — 每个阶段保存产物。可恢复或选择性重新生成任何阶段。rilo --project demo --force
• 您的模型，您做主 — 选择 T2I 和 I2V 模型。覆盖每个模型的选项。随时切换。
• 代码驱动的工作流 — 确定性编排、检查点和产物管理。Token 用于生成，而非基础设施。
• 字幕对齐与烧录 — 自动将字幕对齐到配音时间轴。烧录到最终视频中。
• 预览控制台 — Web 界面用于项目管理、重新生成和资产预览。rilo preview
• HTTP API 与 Webhook — Bearer 令牌认证、OpenAPI 3.1 规范、Webhook 订阅。支持 Firebase 或本地。
• 跨平台 — macOS、Linux、Windows。需要 Node.js 22+ 和 ffmpeg。

快速开始

环境要求：Node.js 22+、PATH 中有 ffmpeg、Replicate API token。

npm install -g @telepat/rilo
rilo settings
rilo --project demo --story-file ./story.txt

预期结果：

• 在 projects/demo/ 下创建项目文件夹。
• 完整流水线依次运行脚本、配音、关键帧、片段和合成。
• 最终视频写入 projects/demo/final.mp4。
• 可通过 rilo preview 打开仪表板预览。

环境要求

• Node.js 22+
• PATH 中有 ffmpeg
• Replicate API token
• macOS、Linux 或 Windows

工作原理

Rilo 运行分阶段流水线：脚本生成、语音合成、镜头提示生成、关键帧渲染、片段生成和最终视频合成。每个阶段都会写入检查点产物，因此你可以恢复或有选择地重新生成。

配置会合并 CLI 标志、环境变量和 ~/.rilo/config.json，并以模式默认值兜底。预览仪表板（rilo preview）启动本地 API、worker 和 Vite React 前端，用于监控和编辑。

与 AI Agent 一起使用

Rilo 为智能体和自动化工作流提供多种接口：

• CLI 自动化 — 所有生成均由 CLI 标志和环境变量驱动。初始设置后无需交互式提示。
• HTTP API — rilo preview 启动 Express API，提供完整的 job 和 project CRUD、资源服务和 webhook 端点。通过 Authorization: Bearer <API_BEARER_TOKEN> 进行 Bearer token 认证。
• OpenAPI 规范 — 自动生成 OpenAPI 3.1 规范，支持基于模式的智能体集成。
• Webhook — 订阅 job 生命周期事件，用于外部编排。
• Firebase Functions — 部署 src/api/firebaseFunction.js 实现无服务器 API 托管。
• Agent 文档 — API 参考 涵盖端点、认证和 webhook。

安全与信任

• API token 和 Replicate 凭证在 OS 密钥库可用时保存（macOS Keychain、Windows Credential Manager、Linux Secret Service）。
• 如果无原生密钥库可用，则回退到 ~/.rilo/.secrets 的 AES-256 加密文件。
• 环境变量（RILO_REPLICATE_API_TOKEN、RILO_API_BEARER_TOKEN）优先级最高，会覆盖已存储的值。
• Preview --expose 模式应仅在可信网络或隔离环境中使用。

文档与支持

• 文档站点
• 快速上手
• CLI 参考
• 配置指南
• API 参考
• 故障排查
• 仓库
• npm 包

贡献

欢迎贡献。请参阅开发指南了解本地环境搭建、构建命令和测试工作流。

许可证

MIT。详见 LICENSE。