Flova CLI 接入 Agent 指南

Flova CLI 让你可以在 Codex、Claude Code 等外部 Agent 里调用 Flova。你只需要把接入提示词发给正在使用的 Agent，它会安装并加载 Flova CLI 与 Flova Skill，连接你的 Flova 账号，然后用自然语言帮你创建项目、推进生成、读取项目状态并导出最终视频。

这不是把 Flova 当作单个图片或视频生成接口来使用。Flova CLI 连接的是完整的 Flova 项目系统：项目需求、对话历史、故事板、媒体素材、文档和剪辑时间线都会保留在同一个项目里。外部 Agent 负责和你对话、调用 CLI、汇报进度；Flova 负责在项目中持续推进视频创作。

适合什么时候使用

当你已经习惯在 Codex、Claude Code 或其他 Agent 环境里工作时，可以用 Flova CLI 让这些 Agent 直接参与视频创作。比如：

在 Codex 里一边整理脚本、参考资料或产品说明，一边让 Flova 创建视频项目。
让 Claude Code 根据你的自然语言需求，调用 Flova 生成故事板、素材和成片。
在外部 Agent 工作流里读取 Flova 项目的真实状态，而不是让 Agent 凭记忆描述进度。
需要长时间生成或导出时，让 Agent 持续观察任务状态，并在完成后把项目链接和结果反馈给你。

接入方式

进入 Flova 的 Flova CLI 页面后，你可以按下面的方式把 Flova 交给正在使用的 Agent：

复制启动提示词

把下面这段话发送给你正在使用的 AI Agent。它会安装并加载 Flova CLI 与 Skill，引导你完成登录，然后按 Flova Skill 继续创作。

示例：

请帮我安装 Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

请帮我安装 Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

说出你要的视频

像平时和 AI 对话一样，说明视频目标、时长、比例、风格、重点内容和最终交付要求。如果你想先选择合适的 Flova Skill，也可以让 Agent 在创建项目前先推荐。

示例：

请使用 Flova 制作一支 30 秒、16:9 的温暖奇幻叙事短片：
停电的夜晚，一只住在城市天台的小机器人发现了一颗会发光的种子，并克服障碍把它送给楼下迷路的小女孩。
节奏需要清楚：前 5 秒交代停电和小机器人登场，中段表现它送出种子的过程，结尾让城市重新亮起来。
开始制作前，请先推荐 2～3 个合适的 Flova Skills，说明各自适合的原因，等我选定后再创建项目。

请使用 Flova 制作一支 30 秒、16:9 的温暖奇幻叙事短片：停电的夜晚，一只住在城市天台的小机器人发现了一颗会发光的种子，并克服障碍把它送给楼下迷路的小女孩。节奏需要清楚：前 5 秒交代停电和小机器人登场，中段表现它送出种子的过程，结尾让城市重新亮起来。开始制作前，请先推荐 2～3 个合适的 Flova Skills，说明各自适合的原因，等我选定后再创建项目。

选择并继续审核

项目推进后，你可以审核进展、提出建议，并告诉 Agent 哪些内容已经确认、哪些地方需要继续修改。

示例：

故事板整体通过，但第三个镜头太暗。只调整第三个镜头，不要修改已经确认的角色设定；调整完成后继续制作。

故事板整体通过，但第三个镜头太暗。只调整第三个镜头，不要修改已经确认的角色设定；调整完成后继续制作。

Agent 会根据提示安装 Flova CLI，并读取 Flova Skill，了解如何创建项目、上传资料、发送创作指令、等待生成结果、读取项目状态和导出视频。

通常情况下，Agent 会通过浏览器登录流程连接你的 Flova 账号。它会打开授权页面，你登录 Flova 并批准后，本地 CLI 就可以继续使用你的账号权限。

如果 Agent 无法打开浏览器，或者你希望把访问权限交给某个外部 Agent，可以在 Flova 页面或账号设置里生成 Agent API Key，再通过安全渠道提供给它。API Key 相当于访问你 Flova 账号的凭证，请像保管密码一样保管；不再使用时可以随时撤销。

Agent 可以做什么

接入后，外部 Agent 可以通过 Flova CLI 做这些事：

创建新项目，或继续已有项目。
上传图片、视频、音频或文档作为项目资料。
向 Flova 发送自然语言创作指令，让 Flova 推进故事板、素材生成、音频、时间线和导出准备。
读取项目里的故事板、媒体素材、文档、对话历史和导出状态。
在生成或导出过程中持续查询任务状态，必要时恢复被中断的本地观察。
当视频准备好后，发起导出，并把项目链接、最终视频和当前状态反馈给你。

和网页端 Flova 的关系

通过 CLI 创建或推进的项目，仍然是普通 Flova 项目。你可以随时回到 Flova 网页端查看故事板、媒体空间、文档区和剪辑时间线，也可以直接在网页端继续编辑。

同样，在网页端已有的项目也可以被外部 Agent 继续处理。Agent 会读取当前项目状态，再基于真实的故事板、素材、文档和导出条件继续工作。

使用建议

给 Agent 的需求尽量说明视频目标、时长、比例、风格、重点内容、已有素材和最终交付要求。
不要只让 Agent “继续生成”；更好的方式是说明当前阶段和下一步，例如先完善故事板、先生成关键帧，或在时间线准备好后导出。
让 Agent 读取项目状态后再汇报进度，避免只根据之前的对话猜测。
API Key 只提供给你信任的 Agent，不要写进代码、日志或共享文档。
长时间生成或导出时，不要把本地 CLI 中断当作项目失败；Flova 后端任务可能仍在继续，Agent 可以通过恢复命令重新找回进度。