Flova CLI 串接 AI 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 可以透過恢復命令重新找回進度。