Yapay zekâ ajanları için Flova CLI rehberi

Flova CLI, Flova’yı Codex ve Claude Code gibi harici Agent ortamlarından kullanmanızı sağlar. Kurulum Prompt’unu kullandığınız Agent’a kopyalamanız yeterlidir; Flova CLI ve Flova Skill’i kurup yükler, Flova hesabınıza bağlanır, ardından doğal dille proje oluşturmanıza, üretimi ilerletmenize, proje durumunu okumanıza ve final videoyu dışa aktarmanıza yardımcı olur.

Bu, Flova’yı tekil bir görüntü veya video üretim API’si gibi kullanmakla aynı şey değildir. Flova CLI, tam Flova proje sistemine bağlanır: proje gereksinimleri, sohbet geçmişi, storyboard, medya, belgeler ve timeline aynı projenin içinde kalır. Harici Agent sizinle konuşur, CLI’ı çağırır ve ilerlemeyi bildirir; Flova ise proje içinde video üretimini ilerletmeye devam eder.

Ne zaman kullanılır

Codex, Claude Code veya başka bir Agent ortamında zaten çalışıyorsanız ve bu Agent’ın video üretimine katılmasını istiyorsanız Flova CLI kullanabilirsiniz. Örneğin:

• Codex içinde senaryo, referans veya ürün notları üzerinde çalışırken Flova’dan video projesi oluşturmasını isteyebilirsiniz.
• Claude Code’dan doğal dil isteğinize göre Flova’yı çağırıp storyboard, medya ve final kurguyu üretmesini isteyebilirsiniz.
• Harici bir Agent’ın ilerlemeyi hafızadan anlatmak yerine Flova projesinin gerçek durumunu okumasını sağlayabilirsiniz.
• Uzun süren üretim veya dışa aktarma görevlerinde Agent’ın görev durumunu izlemeye devam etmesini ve tamamlandığında proje bağlantısı ile final sonucu bildirmesini sağlayabilirsiniz.

Kurulum nasıl çalışır

Flova’da Flova CLI sayfasını açın, ardından Flova’yı kullandığınız Agent’a devredin:

Kurulum Prompt’unu kopyalayın

Aşağıdaki metni kullandığınız AI Agent’a gönderin. Flova CLI ve Skill’i kurup yükler, oturum açmanızda size rehberlik eder ve ardından Flova Skill ile üretime devam eder.

Örnek:

Flova CLI kurulumunda bana yardımcı ol: https://cli.flova.ai/flovaCLI-setup.md

Videoyu tarif edin

Videoyu normal bir yapay zekâ sohbetinde anlatır gibi tarif edin. Video hedefini, süresini, en boy oranını, stilini, temel içeriğini ve final teslim beklentisini ekleyin. Önce doğru Flova Skill’i seçmek istiyorsanız, Agent’tan proje oluşturmadan önce seçenekler önermesini isteyin.

Örnek:

Flova kullanarak 30 saniyelik, 16:9 oranında sıcak ve fantastik anlatımlı bir kısa film üret:Elektrik kesintisi yaşanan bir gecede, şehir çatısında yaşayan küçük bir robot ışıldayan bir tohum bulur ve onu aşağı katta kaybolmuş küçük bir kıza ulaştırmak için engelleri aşar.Tempo net olmalı: İlk 5 saniye elektrik kesintisini kurup robotu tanıtsın, orta bölüm tohumu ulaştırma sürecini göstersin, finalde şehir yeniden aydınlansın.Üretime başlamadan önce uygun 2-3 Flova Skills öner, her birinin neden uygun olduğunu açıkla ve projeyi oluşturmadan önce seçimimi bekle.

Seçin ve incelemeye devam edin

Proje ilerledikçe çalışmayı inceleyebilir, geri bildirim verebilir ve Agent’a nelerin onaylandığını, nelerin sırada değişmesi gerektiğini söyleyebilirsiniz.

Örnek:

Storyboard genel olarak onaylandı, ancak üçüncü shot çok karanlık. Yalnızca üçüncü shot’ı ayarla, onaylanmış karakter tasarımını değiştirme ve ayar tamamlandıktan sonra üretime devam et.

Agent, Flova CLI’ı kurmak ve Flova Skill’i okumak için kurulum Prompt’unu izler. Bu Skill; proje oluşturmayı, materyal yüklemeyi, yaratıcı talimat göndermeyi, üretim sonuçlarını beklemeyi, proje durumunu okumayı ve videoları dışa aktarmayı açıklar.

Çoğu durumda Agent, tarayıcı oturum açma akışı üzerinden Flova hesabınıza bağlanır. Bir yetkilendirme sayfası açar; Flova’ya giriş yapıp isteği onayladıktan sonra yerel CLI hesap izinlerinizle devam edebilir.

Agent tarayıcı açamıyorsa veya harici bir Agent’ı doğrudan yetkilendirmek istiyorsanız, Flova sayfasından veya hesap ayarlarından bir Agent API Key oluşturup güvenli bir kanaldan verebilirsiniz. API Key, Flova hesabınıza erişim sağlar; bu yüzden onu parola gibi saklayın. Artık ihtiyaç duymadığınızda istediğiniz zaman iptal edebilirsiniz.

Agent neler yapabilir

Kurulumdan sonra harici bir Agent, Flova CLI ile şunları yapabilir:

• Yeni proje oluşturmak veya mevcut projeye devam etmek.
• Görselleri, videoları, sesleri veya belgeleri proje materyali olarak yüklemek.
• Flova’ya doğal dilde yaratıcı talimatlar göndererek storyboard, medya üretimi, ses, timeline ve dışa aktarma hazırlığını ilerletmek.
• Projenin storyboard’unu, medyasını, belgelerini, sohbet geçmişini ve dışa aktarma durumunu okumak.
• Üretim veya dışa aktarma sırasında görev durumunu kontrol etmeye devam etmek ve kesintiye uğrayan yerel gözlemi kurtarmak.
• Video hazır olduğunda dışa aktarmayı başlatmak, ardından proje bağlantısı, final video ve mevcut durumla geri bildirmek.

Flova web uygulamasıyla ilişkisi

CLI ile oluşturulan veya ilerletilen projeler hâlâ normal Flova projeleridir. İstediğiniz zaman Flova web uygulamasına dönerek storyboard, Media Space, Docs panel ve Timeline’ı inceleyebilir veya web uygulamasında doğrudan düzenlemeye devam edebilirsiniz.

Aynı şey ters yönde de geçerlidir: Harici bir Agent, mevcut bir web projesi üzerinde çalışmaya devam edebilir. Mevcut proje durumunu okur, ardından gerçek storyboard, medya, belgeler ve dışa aktarma hazırlığına göre devam eder.

Kullanım ipuçları

• Agent’a video hedefini, süresini, en boy oranını, stilini, önemli noktaları, mevcut materyalleri ve final teslim beklentisini anlatın.
• Yalnızca “üretmeye devam et” demekten kaçının. Mevcut aşamayı ve sonraki adımı belirtmek daha iyidir; örneğin önce storyboard’u netleştirmek, önce keyframe üretmek veya timeline hazır olduğunda dışa aktarmak.
• Agent’ın ilerleme bildirmeden önce proje durumunu okumasını isteyin, böylece önceki konuşmadan tahmin yürütmez.
• API Keys’i yalnızca güvendiğiniz Agent’larla paylaşın. Kodlara, loglara veya paylaşılan belgelere koymayın.
• Uzun üretim veya dışa aktarma görevlerinde yerel CLI kesintisini proje hatası olarak görmeyin. Flova backend görevi hâlâ çalışıyor olabilir ve Agent ilerlemeyi CLI üzerinden kurtarabilir.