Hướng dẫn Flova CLI dành cho AI Agent

Flova CLI cho phép bạn dùng Flova từ các Agent bên ngoài như Codex và Claude Code. Bạn chỉ cần sao chép Prompt thiết lập vào Agent đang dùng; Agent sẽ cài đặt và tải Flova CLI cùng Flova Skill, kết nối với tài khoản Flova của bạn, rồi hỗ trợ bằng ngôn ngữ tự nhiên để tạo dự án, thúc đẩy quá trình tạo nội dung, đọc trạng thái dự án và xuất video cuối cùng.

Đây không phải là cách dùng Flova như một API tạo ảnh hoặc video đơn lẻ. Flova CLI kết nối với toàn bộ hệ thống dự án Flova: yêu cầu dự án, lịch sử trò chuyện, storyboard, media, tài liệu và timeline đều được giữ trong cùng một dự án. Agent bên ngoài trò chuyện với bạn, gọi CLI và báo cáo tiến độ; Flova tiếp tục thúc đẩy quá trình sáng tạo video trong dự án.

Khi nào nên dùng

Dùng Flova CLI khi bạn đã quen làm việc trong Codex, Claude Code hoặc một môi trường Agent khác và muốn Agent đó tham gia vào quá trình sáng tạo video. Ví dụ:

• Làm việc trong Codex với kịch bản, tài liệu tham khảo hoặc ghi chú sản phẩm, đồng thời yêu cầu Flova tạo dự án video.
• Yêu cầu Claude Code gọi Flova để tạo storyboard, media và bản dựng cuối từ yêu cầu ngôn ngữ tự nhiên của bạn.
• Để một Agent bên ngoài đọc trạng thái thật của dự án Flova thay vì mô tả tiến độ theo trí nhớ.
• Với các tác vụ tạo nội dung hoặc xuất video kéo dài, để Agent tiếp tục theo dõi trạng thái và báo lại liên kết dự án cùng kết quả cuối khi hoàn tất.

Cách thiết lập

Mở trang Flova CLI trong Flova, rồi giao Flova cho Agent bạn đang dùng:

Sao chép Prompt thiết lập

Gửi đoạn văn dưới đây cho AI Agent bạn đang dùng. Agent sẽ cài đặt và tải Flova CLI cùng Skill, hướng dẫn bạn đăng nhập, rồi tiếp tục sáng tạo theo Flova Skill.

Ví dụ:

Hãy giúp tôi cài đặt Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

Mô tả video bạn muốn

Mô tả video như khi bạn trò chuyện bình thường với AI. Hãy nêu mục tiêu video, thời lượng, tỷ lệ khung hình, phong cách, nội dung trọng tâm và kỳ vọng bàn giao cuối cùng. Nếu muốn chọn Flova Skill phù hợp trước, bạn có thể yêu cầu Agent đề xuất các lựa chọn trước khi tạo dự án.

Ví dụ:

Hãy dùng Flova để tạo một phim ngắn kể chuyện ấm áp pha kỳ ảo, dài 30 giây, tỷ lệ 16:9:Trong đêm mất điện, một robot nhỏ sống trên sân thượng thành phố phát hiện một hạt giống phát sáng và vượt qua các trở ngại để mang nó cho một cô bé bị lạc ở tầng dưới.Nhịp kể cần rõ ràng: 5 giây đầu giới thiệu cảnh mất điện và robot nhỏ xuất hiện, đoạn giữa thể hiện quá trình nó mang hạt giống đi, phần kết cho thấy thành phố sáng trở lại.Trước khi bắt đầu sản xuất, hãy đề xuất 2-3 Flova Skills phù hợp, giải thích lý do từng Skill phù hợp, rồi đợi tôi chọn xong mới tạo dự án.

Chọn và tiếp tục duyệt

Khi dự án tiến triển, bạn có thể duyệt tiến độ, đưa góp ý và nói với Agent nội dung nào đã được xác nhận, phần nào cần sửa tiếp.

Ví dụ:

Storyboard nhìn chung đã duyệt, nhưng shot thứ ba quá tối. Chỉ điều chỉnh shot thứ ba, không thay đổi thiết kế nhân vật đã xác nhận; sau khi điều chỉnh xong hãy tiếp tục sản xuất.

Agent sẽ làm theo Prompt thiết lập để cài đặt Flova CLI và đọc Flova Skill, trong đó giải thích cách tạo dự án, tải tài liệu lên, gửi chỉ dẫn sáng tạo, chờ kết quả tạo nội dung, đọc trạng thái dự án và xuất video.

Trong hầu hết trường hợp, Agent kết nối với tài khoản Flova của bạn qua luồng đăng nhập bằng trình duyệt. Agent mở trang cấp quyền; sau khi bạn đăng nhập Flova và chấp thuận, CLI cục bộ có thể tiếp tục dùng quyền tài khoản của bạn.

Nếu Agent không thể mở trình duyệt, hoặc bạn muốn cấp quyền trực tiếp cho một Agent bên ngoài, bạn có thể tạo Agent API Key từ trang Flova hoặc phần cài đặt tài khoản rồi cung cấp qua kênh an toàn. API Key cấp quyền truy cập tài khoản Flova của bạn, vì vậy hãy bảo quản như mật khẩu. Khi không cần nữa, bạn có thể thu hồi bất cứ lúc nào.

Agent có thể làm gì

Sau khi thiết lập, Agent bên ngoài có thể dùng Flova CLI để:

• Tạo dự án mới hoặc tiếp tục dự án hiện có.
• Tải ảnh, video, âm thanh hoặc tài liệu lên làm tư liệu dự án.
• Gửi chỉ dẫn sáng tạo bằng ngôn ngữ tự nhiên cho Flova để thúc đẩy storyboard, tạo media, âm thanh, timeline và chuẩn bị xuất.
• Đọc storyboard, media, tài liệu, lịch sử trò chuyện và trạng thái xuất của dự án.
• Tiếp tục kiểm tra trạng thái tác vụ trong quá trình tạo hoặc xuất, và khôi phục việc theo dõi cục bộ nếu bị gián đoạn.
• Bắt đầu xuất khi video đã sẵn sàng, rồi báo lại liên kết dự án, video cuối và trạng thái hiện tại.

Quan hệ với ứng dụng web Flova

Dự án được tạo hoặc tiếp tục qua CLI vẫn là dự án Flova thông thường. Bạn có thể quay lại ứng dụng web Flova bất cứ lúc nào để xem storyboard, Media Space, Docs panel và Timeline, hoặc tiếp tục chỉnh sửa trực tiếp trong ứng dụng web.

Điều ngược lại cũng đúng: một Agent bên ngoài có thể tiếp tục làm việc trên dự án web đã có. Agent đọc trạng thái hiện tại của dự án, rồi tiếp tục dựa trên storyboard, media, tài liệu và mức sẵn sàng xuất thực tế.

Gợi ý sử dụng

• Hãy nói rõ với Agent mục tiêu video, thời lượng, tỷ lệ khung hình, phong cách, điểm chính, tư liệu hiện có và kỳ vọng bàn giao cuối.
• Tránh chỉ nói “tiếp tục tạo”. Tốt hơn là nêu giai đoạn hiện tại và bước tiếp theo, ví dụ trước tiên hoàn thiện storyboard, trước tiên tạo keyframe, hoặc xuất khi timeline đã sẵn sàng.
• Yêu cầu Agent đọc trạng thái dự án trước khi báo cáo tiến độ, để tránh đoán dựa trên cuộc trò chuyện trước đó.
• Chỉ chia sẻ API Keys với Agent bạn tin tưởng. Không đưa chúng vào code, log hoặc tài liệu chia sẻ.
• Với các tác vụ tạo nội dung hoặc xuất video kéo dài, đừng xem việc CLI cục bộ bị gián đoạn là dự án thất bại. Tác vụ backend của Flova có thể vẫn đang chạy, và Agent có thể khôi phục tiến độ qua CLI.