AI 에이전트용 Flova CLI 가이드

Flova CLI를 사용하면 Codex, Claude Code 같은 외부 Agent 안에서 Flova를 호출할 수 있습니다. 사용 중인 Agent에게 설정 Prompt를 보내기만 하면, Agent가 Flova CLI와 Flova Skill을 설치하고 로드한 뒤 Flova 계정에 연결하고, 자연어로 프로젝트 생성, 생성 진행, 프로젝트 상태 확인, 최종 영상 내보내기를 도와줍니다.

이는 Flova를 단일 이미지 또는 영상 생성 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

Flova CLI 설치를 도와주세요: https://cli.flova.ai/flovaCLI-setup.md

원하는 영상을 설명하기

평소 AI와 대화하듯 영상 목표, 길이, 화면 비율, 스타일, 핵심 내용, 최종 납품 요구사항을 설명하세요. 먼저 적합한 Flova Skill을 고르고 싶다면, 프로젝트를 만들기 전에 Agent에게 추천을 요청할 수도 있습니다.

예시:

Flova를 사용해 30초, 16:9의 따뜻한 판타지 내러티브 단편을 제작해 주세요:
정전된 밤, 도시 옥상에 사는 작은 로봇이 빛나는 씨앗을 발견하고 장애물을 넘어 아래층에서 길을 잃은 어린 소녀에게 전달합니다.
리듬은 명확해야 합니다. 처음 5초는 정전과 작은 로봇의 등장을 보여주고, 중반부는 씨앗을 전달하는 과정을 보여주며, 마지막에는 도시가 다시 밝아지게 해 주세요.
제작을 시작하기 전에 적합한 Flova Skills 2~3개를 먼저 추천하고, 각각이 적합한 이유를 설명한 뒤, 제가 선택하면 프로젝트를 만들어 주세요.

Flova를 사용해 30초, 16:9의 따뜻한 판타지 내러티브 단편을 제작해 주세요:정전된 밤, 도시 옥상에 사는 작은 로봇이 빛나는 씨앗을 발견하고 장애물을 넘어 아래층에서 길을 잃은 어린 소녀에게 전달합니다.리듬은 명확해야 합니다. 처음 5초는 정전과 작은 로봇의 등장을 보여주고, 중반부는 씨앗을 전달하는 과정을 보여주며, 마지막에는 도시가 다시 밝아지게 해 주세요.제작을 시작하기 전에 적합한 Flova Skills 2~3개를 먼저 추천하고, 각각이 적합한 이유를 설명한 뒤, 제가 선택하면 프로젝트를 만들어 주세요.

선택하고 계속 검토하기

프로젝트가 진행되면 작업을 검토하고 피드백을 주며, 이미 확정된 내용과 다음에 수정해야 할 내용을 Agent에게 알려줄 수 있습니다.

예시:

스토리보드는 전체적으로 승인하지만, 세 번째 샷이 너무 어둡습니다. 세 번째 샷만 조정하고 이미 확정된 캐릭터 설정은 변경하지 마세요. 조정이 끝나면 제작을 계속해 주세요.

스토리보드는 전체적으로 승인하지만, 세 번째 샷이 너무 어둡습니다. 세 번째 샷만 조정하고 이미 확정된 캐릭터 설정은 변경하지 마세요. 조정이 끝나면 제작을 계속해 주세요.

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 웹 앱과의 관계

CLI로 만들거나 진행한 프로젝트도 일반 Flova 프로젝트입니다. 언제든 Flova 웹 앱으로 돌아와 스토리보드, Media Space, Docs panel, Timeline을 확인하거나 웹 앱에서 직접 편집을 계속할 수 있습니다.

반대로 웹 앱에 이미 있는 프로젝트도 외부 Agent가 계속 처리할 수 있습니다. Agent는 현재 프로젝트 상태를 읽고 실제 스토리보드, 미디어, 문서, 내보내기 준비 상태를 바탕으로 계속 작업합니다.

사용 팁

Agent에게 영상 목표, 길이, 화면 비율, 스타일, 핵심 내용, 기존 자료, 최종 납품 요구사항을 최대한 설명하세요.
Agent에게 단순히 “계속 생성해”라고만 말하지 않는 것이 좋습니다. 현재 단계와 다음 단계를 설명하세요. 예를 들어 스토리보드를 먼저 다듬기, 키프레임을 먼저 생성하기, 타임라인이 준비되면 내보내기 등이 있습니다.
Agent가 진행 상황을 보고하기 전에 프로젝트 상태를 읽게 하면, 이전 대화만으로 추측하는 일을 줄일 수 있습니다.
API Key는 신뢰하는 Agent에게만 공유하세요. 코드, 로그, 공유 문서에 넣지 마세요.
생성이나 내보내기가 오래 걸릴 때 로컬 CLI 중단을 프로젝트 실패로 보지 마세요. Flova 백엔드 작업은 계속 실행 중일 수 있고, Agent는 CLI 복구 명령으로 진행 상황을 다시 찾을 수 있습니다.