AIエージェント向けFlova CLIガイド

Flova CLI を使うと、Codex や Claude Code などの外部 Agent から Flova を呼び出せます。使っている Agent にセットアップ用 Prompt を渡すだけで、Agent は Flova CLI と Flova Skill をインストールして読み込み、あなたの Flova アカウントに接続し、自然言語でプロジェクト作成、生成の進行、プロジェクト状態の読み取り、最終動画のエクスポートを手伝います。

これは、Flova を単体の画像生成 API や動画生成 API として使うものではありません。Flova CLI が接続するのは、Flova の完全なプロジェクトシステムです。制作要件、チャット履歴、ストーリーボード、メディア、ドキュメント、タイムラインが同じプロジェクト内に保持されます。外部 Agent はあなたと対話し、CLI を呼び出し、進捗を報告します。Flova はプロジェクト内で動画制作を継続的に進めます。

使う場面

Codex、Claude Code、または他の Agent 環境で作業することに慣れていて、その Agent に動画制作へ参加してほしいときに Flova CLI を使えます。たとえば：

• Codex で脚本、参考資料、製品説明を整理しながら、Flova に動画プロジェクトを作らせる。
• Claude Code に自然言語の要望を渡し、Flova を呼び出してストーリーボード、素材、完成動画を生成させる。
• 外部 Agent のワークフローで、記憶に頼らず Flova プロジェクトの実際の状態を読み取る。
• 長時間の生成やエクスポートでは、Agent にタスク状態を継続的に確認させ、完了後にプロジェクトリンクと結果を報告させる。

接続方法

Flova の Flova CLI ページを開いたら、次の流れで Flova を使用中の Agent に渡します：

セットアップ用 Prompt をコピーする

以下の文を、使用中の AI Agent に送ってください。Agent は Flova CLI と Skill をインストールして読み込み、サインインを案内し、その後 Flova Skill に沿って制作を続けます。

例：

Flova CLI のインストールを手伝ってください: https://cli.flova.ai/flovaCLI-setup.md

作りたい動画を伝える

普段 AI と会話するように、動画の目的、長さ、アスペクト比、スタイル、重要な内容、最終的な納品要件を伝えます。先に適した Flova Skill を選びたい場合は、プロジェクト作成前に Agent に候補を推薦してもらうこともできます。

例：

Flova を使って、30 秒、16:9 の温かいファンタジー調の物語短編を制作してください：停電の夜、街の屋上に住む小さなロボットが光る種を見つけ、障害を乗り越えて階下で迷子になっている小さな女の子に届けます。テンポは明確にしてください：最初の 5 秒で停電と小さなロボットの登場を描き、中盤で種を届ける過程を見せ、最後に街が再び明るくなるようにしてください。制作を始める前に、適した Flova Skills を 2～3 個推薦し、それぞれが合う理由を説明してください。私が選んでからプロジェクトを作成してください。

選択し、レビューを続ける

プロジェクトが進んだら、進捗を確認し、フィードバックを出し、どの内容が承認済みで、どこを次に変更すべきかを Agent に伝えます。

例：

ストーリーボード全体は承認しますが、3 番目のショットが暗すぎます。3 番目のショットだけを調整し、確認済みのキャラクター設定は変更しないでください。調整が終わったら制作を続けてください。

Agent はセットアップ用 Prompt に従って Flova CLI をインストールし、Flova Skill を読み込みます。そこには、プロジェクト作成、資料アップロード、制作指示の送信、生成結果の待機、プロジェクト状態の読み取り、動画エクスポートの方法が説明されています。

ほとんどの場合、Agent はブラウザのサインインフローを通じてあなたの Flova アカウントに接続します。認証ページが開き、Flova にサインインして承認すると、ローカル CLI はあなたのアカウント権限で続行できます。

Agent がブラウザを開けない場合、または外部 Agent に直接権限を渡したい場合は、Flova ページまたはアカウント設定で Agent API Key を生成し、安全な経路で提供できます。API Key は Flova アカウントへのアクセス資格情報なので、パスワードと同じように扱ってください。不要になったらいつでも取り消せます。

Agent ができること

接続後、外部 Agent は Flova CLI を使って次のことができます：

• 新しいプロジェクトを作成する、または既存プロジェクトを続行する。
• 画像、動画、音声、ドキュメントをプロジェクト資料としてアップロードする。
• Flova に自然言語の制作指示を送り、ストーリーボード、素材生成、音声、タイムライン、エクスポート準備を進める。
• プロジェクトのストーリーボード、メディア、ドキュメント、チャット履歴、エクスポート状態を読み取る。
• 生成やエクスポート中にタスク状態を継続的に確認し、ローカルでの観察が中断された場合に復旧する。
• 動画の準備ができたらエクスポートを開始し、プロジェクトリンク、最終動画、現在の状態を報告する。

Flova Web アプリとの関係

CLI で作成または進行したプロジェクトも、通常の Flova プロジェクトです。いつでも Flova Web アプリに戻って、ストーリーボード、Media Space、Docs panel、Timeline を確認したり、Web アプリで直接編集を続けたりできます。

逆方向も同じです。Web アプリに既にあるプロジェクトを、外部 Agent が引き続き処理することもできます。Agent は現在のプロジェクト状態を読み取り、実際のストーリーボード、メディア、ドキュメント、エクスポート準備状況に基づいて続行します。

使い方のヒント

• Agent には、動画の目的、長さ、アスペクト比、スタイル、重要な内容、既存素材、最終納品要件をできるだけ伝えてください。
• Agent に「生成を続けて」とだけ言うのは避けましょう。現在の段階と次のステップを伝える方がよいです。たとえば、先にストーリーボードを整える、先にキーフレームを生成する、タイムラインの準備ができたらエクスポートする、などです。
• 進捗報告の前に Agent にプロジェクト状態を読み取らせると、以前の会話だけから推測するのを避けられます。
• API Key は信頼できる Agent にだけ共有してください。コード、ログ、共有ドキュメントには書かないでください。
• 長時間の生成やエクスポートでは、ローカル CLI の中断をプロジェクト失敗と見なさないでください。Flova のバックエンドタスクはまだ実行中の場合があり、Agent は CLI の復旧コマンドで進捗を取り戻せます。