Руководство по Flova CLI для ИИ-агентов

Flova CLI позволяет использовать Flova из внешних Agent, таких как Codex и Claude Code. Достаточно скопировать setup Prompt в Agent, которым вы пользуетесь: он установит и загрузит Flova CLI и Flova Skill, подключится к вашему аккаунту Flova, а затем на естественном языке поможет создавать проекты, запускать генерацию, читать состояние проекта и экспортировать финальное видео.

Это не то же самое, что использовать Flova как отдельный API для генерации изображений или видео. Flova CLI подключается к полноценной проектной системе Flova: требования проекта, история чата, storyboard, медиа, документы и timeline остаются внутри одного проекта. Внешний Agent общается с вами, вызывает CLI и сообщает о прогрессе; Flova продолжает продвигать создание видео внутри проекта.

Когда использовать

Используйте Flova CLI, если вы уже работаете в Codex, Claude Code или другой среде Agent и хотите, чтобы этот Agent участвовал в создании видео. Например:

• Работать в Codex над сценариями, референсами или заметками о продукте и одновременно просить Flova создать видеопроект.
• Попросить Claude Code вызвать Flova и сгенерировать storyboard, медиа и финальный монтаж по вашему запросу на естественном языке.
• Дать внешнему Agent возможность читать реальное состояние проекта Flova, а не описывать прогресс по памяти.
• Для долгих задач генерации или экспорта позволить Agent отслеживать состояние задачи и вернуться с ссылкой на проект и финальным результатом после завершения.

Как настроить

Откройте страницу Flova CLI в Flova, затем передайте Flova Agent, которым вы пользуетесь:

Скопируйте setup Prompt

Отправьте текст ниже AI Agent, которым вы пользуетесь. Он установит и загрузит Flova CLI и Skill, проведёт вас через вход и затем продолжит создание с Flova Skill.

Пример:

Помоги мне установить Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

Опишите видео

Опишите видео так, как обычно общаетесь с ИИ. Укажите цель видео, длительность, соотношение сторон, стиль, ключевое содержание и ожидание по финальной передаче результата. Если вы хотите сначала выбрать подходящий Flova Skill, попросите Agent порекомендовать варианты до создания проекта.

Пример:

Используй Flova, чтобы создать тёплый фантазийный повествовательный короткий фильм на 30 секунд в формате 16:9:В ночь отключения электричества маленький робот, живущий на крыше в городе, находит светящееся семя и преодолевает препятствия, чтобы отнести его потерявшейся девочке внизу.Ритм должен быть чётким: первые 5 секунд показывают отключение электричества и знакомят с роботом, середина показывает, как он доставляет семя, а финал показывает, как город снова загорается.Перед началом производства порекомендуй 2-3 подходящих Flova Skills, объясни, почему каждый подходит, и дождись моего выбора перед созданием проекта.

Выберите и продолжайте проверку

По мере продвижения проекта вы можете проверять работу, давать обратную связь и сообщать Agent, что уже утверждено, а что нужно изменить дальше.

Пример:

Storyboard в целом утверждён, но третий shot слишком тёмный. Исправь только третий shot, не меняй уже утверждённый дизайн персонажа, и продолжай производство после завершения правки.

Agent следует setup Prompt, устанавливает Flova CLI и читает Flova Skill, где объясняется, как создавать проекты, загружать материалы, отправлять творческие инструкции, ждать результатов генерации, читать состояние проекта и экспортировать видео.

В большинстве случаев Agent подключается к вашему аккаунту Flova через вход в браузере. Он открывает страницу авторизации; после того как вы войдёте в Flova и одобрите запрос, локальный CLI сможет продолжить с правами вашего аккаунта.

Если Agent не может открыть браузер или вы хотите напрямую авторизовать внешнего Agent, вы можете создать Agent API Key на странице Flova или в настройках аккаунта и передать его по защищённому каналу. API Key даёт доступ к вашему аккаунту Flova, поэтому относитесь к нему как к паролю. Вы можете отозвать его, когда он больше не нужен.

Что может делать Agent

После настройки внешний Agent может использовать Flova CLI, чтобы:

• Создать новый проект или продолжить существующий.
• Загружать изображения, видео, аудио или документы как материалы проекта.
• Отправлять Flova творческие инструкции на естественном языке, чтобы продвигать storyboard, генерацию медиа, аудио, timeline и подготовку экспорта.
• Читать storyboard, медиа, документы, историю чата и статус экспорта проекта.
• Продолжать проверять статус задачи во время генерации или экспорта и восстанавливать локальное наблюдение, если оно было прервано.
• Запустить экспорт, когда видео готово, а затем сообщить ссылку на проект, финальное видео и текущий статус.

Связь с веб-приложением Flova

Проекты, созданные или продвинутые через CLI, остаются обычными проектами Flova. Вы можете в любой момент вернуться в веб-приложение Flova, чтобы посмотреть storyboard, Media Space, Docs panel и Timeline, или продолжить редактирование прямо в веб-приложении.

То же работает и в обратную сторону: внешний Agent может продолжить работу над существующим веб-проектом. Он читает текущее состояние проекта и продолжает на основе реального storyboard, медиа, документов и готовности к экспорту.

Советы по использованию

• Сообщите Agent цель видео, длительность, соотношение сторон, стиль, ключевые моменты, существующие материалы и ожидание по финальной передаче.
• Не ограничивайтесь фразой «продолжай генерировать». Лучше указать текущий этап и следующий шаг, например сначала доработать storyboard, сначала сгенерировать keyframes или экспортировать после готовности timeline.
• Попросите Agent читать состояние проекта перед отчётом о прогрессе, чтобы он не гадал по предыдущему разговору.
• Делитесь API Keys только с Agent, которым доверяете. Не помещайте их в код, логи или общие документы.
• При долгой генерации или экспорте не считайте локальное прерывание CLI провалом проекта. Backend-задача Flova может продолжать выполняться, а Agent может восстановить прогресс через CLI.