คู่มือ Flova CLI สำหรับ AI Agent

Flova CLI ช่วยให้คุณใช้ Flova จาก Agent ภายนอก เช่น Codex และ Claude Code ได้ เพียงคัดลอก Prompt สำหรับตั้งค่าไปยัง Agent ที่คุณใช้อยู่ Agent จะติดตั้งและโหลด Flova CLI กับ Flova Skill เชื่อมต่อกับบัญชี Flova ของคุณ จากนั้นช่วยคุณสร้างโปรเจกต์ เดินหน้าการสร้าง อ่านสถานะโปรเจกต์ และส่งออกวิดีโอสุดท้ายด้วยภาษาธรรมชาติ

นี่ไม่ใช่การใช้ Flova เป็น API เดี่ยวสำหรับสร้างภาพหรือวิดีโอ Flova CLI เชื่อมต่อกับระบบโปรเจกต์ Flova แบบเต็ม: ความต้องการของโปรเจกต์ ประวัติแชต storyboard, media, documents และ timeline จะอยู่ในโปรเจกต์เดียวกันทั้งหมด Agent ภายนอกจะคุยกับคุณ เรียกใช้ CLI และรายงานความคืบหน้า ส่วน Flova จะเดินหน้าการสร้างวิดีโอภายในโปรเจกต์ต่อไป

ใช้เมื่อไหร่ดี

ใช้ Flova CLI เมื่อคุณทำงานใน Codex, Claude Code หรือสภาพแวดล้อม Agent อื่นอยู่แล้ว และต้องการให้ Agent นั้นเข้ามามีส่วนร่วมในการสร้างวิดีโอ เช่น:

• ทำงานใน Codex กับสคริปต์ เอกสารอ้างอิง หรือโน้ตสินค้า พร้อมขอให้ Flova สร้างโปรเจกต์วิดีโอ
• ขอให้ Claude Code เรียก Flova เพื่อสร้าง storyboard, media และงานตัดต่อสุดท้ายจากคำขอภาษาธรรมชาติของคุณ
• ให้ Agent ภายนอกอ่านสถานะจริงของโปรเจกต์ Flova แทนการอธิบายความคืบหน้าจากความจำ
• สำหรับงานสร้างหรือส่งออกที่ใช้เวลานาน ให้ Agent คอยติดตามสถานะงานและรายงานลิงก์โปรเจกต์กับผลลัพธ์สุดท้ายเมื่อเสร็จ

วิธีตั้งค่า

เปิดหน้า Flova CLI ใน Flova แล้วส่งต่อ 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 ได้ว่าส่วนใดอนุมัติแล้ว ส่วนใดต้องแก้ต่อ

ตัวอย่าง:

storyboard โดยรวมอนุมัติแล้ว แต่ shot ที่สามมืดเกินไป ปรับเฉพาะ shot ที่สาม ห้ามเปลี่ยนดีไซน์ตัวละครที่ยืนยันแล้ว และเมื่อปรับเสร็จให้ผลิตต่อ

Agent จะทำตาม Prompt สำหรับตั้งค่าเพื่อติดตั้ง Flova CLI และอ่าน Flova Skill ซึ่งอธิบายวิธีสร้างโปรเจกต์ อัปโหลดวัสดุ ส่งคำสั่งสร้างสรรค์ รอผลการสร้าง อ่านสถานะโปรเจกต์ และส่งออกวิดีโอ

โดยทั่วไป Agent จะเชื่อมต่อบัญชี Flova ของคุณผ่านขั้นตอนเข้าสู่ระบบในเบราว์เซอร์ Agent จะเปิดหน้าการอนุญาต หลังจากคุณเข้าสู่ระบบ Flova และอนุมัติแล้ว CLI บนเครื่องจะใช้สิทธิ์บัญชีของคุณต่อได้

หาก Agent เปิดเบราว์เซอร์ไม่ได้ หรือคุณต้องการอนุญาต Agent ภายนอกโดยตรง คุณสามารถสร้าง Agent API Key จากหน้า Flova หรือการตั้งค่าบัญชี แล้วส่งให้ผ่านช่องทางที่ปลอดภัย API Key ให้สิทธิ์เข้าถึงบัญชี Flova ของคุณ จึงควรดูแลเหมือนรหัสผ่าน และสามารถเพิกถอนได้เมื่อไม่ต้องการใช้แล้ว

Agent ทำอะไรได้บ้าง

หลังตั้งค่าแล้ว Agent ภายนอกสามารถใช้ Flova CLI เพื่อ:

• สร้างโปรเจกต์ใหม่ หรือทำงานต่อจากโปรเจกต์ที่มีอยู่
• อัปโหลดรูปภาพ วิดีโอ เสียง หรือเอกสารเป็นวัสดุของโปรเจกต์
• ส่งคำสั่งสร้างสรรค์ด้วยภาษาธรรมชาติให้ Flova เพื่อเดินหน้า storyboard, การสร้าง media, เสียง, timeline และการเตรียมส่งออก
• อ่าน storyboard, media, documents, ประวัติแชต และสถานะการส่งออกของโปรเจกต์
• ตรวจสถานะงานต่อเนื่องระหว่างการสร้างหรือส่งออก และกู้การติดตามบนเครื่องหากถูกขัดจังหวะ
• เริ่มส่งออกเมื่อวิดีโอพร้อม แล้วรายงานลิงก์โปรเจกต์ วิดีโอสุดท้าย และสถานะปัจจุบันกลับมา

ความสัมพันธ์กับเว็บแอป Flova

โปรเจกต์ที่สร้างหรือเดินหน้าผ่าน CLI ยังคงเป็นโปรเจกต์ Flova ปกติ คุณสามารถกลับไปที่เว็บแอป Flova ได้ทุกเมื่อเพื่อดู storyboard, Media Space, Docs panel และ Timeline หรือแก้ไขต่อโดยตรงในเว็บแอป

ในทางกลับกัน Agent ภายนอกก็สามารถทำงานต่อจากโปรเจกต์เว็บที่มีอยู่ได้เช่นกัน Agent จะอ่านสถานะโปรเจกต์ปัจจุบัน แล้วทำงานต่อจาก storyboard, media, documents และความพร้อมส่งออกจริง

คำแนะนำการใช้งาน

• บอก Agent ให้ชัดเจนเรื่องเป้าหมายวิดีโอ ความยาว อัตราส่วนภาพ สไตล์ จุดสำคัญ วัสดุที่มีอยู่ และความคาดหวังในการส่งมอบสุดท้าย
• หลีกเลี่ยงการพูดแค่ว่า “สร้างต่อ” ควรบอกขั้นตอนปัจจุบันและขั้นตอนถัดไป เช่น ปรับ storyboard ก่อน สร้าง keyframes ก่อน หรือส่งออกเมื่อ Timeline พร้อม
• ให้ Agent อ่านสถานะโปรเจกต์ก่อนรายงานความคืบหน้า เพื่อไม่ให้เดาจากบทสนทนาก่อนหน้า
• แชร์ API Keys เฉพาะกับ Agent ที่คุณไว้ใจ อย่าใส่ไว้ในโค้ด log หรือเอกสารที่แชร์
• สำหรับงานสร้างหรือส่งออกที่ใช้เวลานาน อย่าถือว่าการหยุดชะงักของ CLI บนเครื่องคือโปรเจกต์ล้มเหลว งาน backend ของ Flova อาจยังทำงานอยู่ และ Agent สามารถกู้ความคืบหน้าผ่าน CLI ได้