การกำหนดค่า Runway Video API
Runway เป็นแพลตฟอร์มสร้างวิดีโอ ซึ่งโดยปกติแล้วจะไม่ใช่ Base URL สำหรับกรอกใน Chatbox แต่ให้สร้าง API Key บนแพลตฟอร์ม Runway แล้วใช้ SDK ทางการหรือคำขอ HTTP เพื่อสร้างงานวิดีโอแทน
ข้อมูลทางการ การดาวน์โหลดและเอกสารอ้างอิงให้ยึดตามเว็บไซต์ทางการเป็นหลัก
เหมาะสำหรับสถานการณ์ใดบ้าง
Text-to-VideoImage-to-Videoงานแบบ AsynchronousSDK ทางการ
ทำความเข้าใจขั้นตอนการทำงานของ Video Task ก่อน
- สร้าง API Key และตรวจสอบให้แน่ใจว่าบัญชีของคุณมีสิทธิ์ใช้งาน Video API และมียอดคงเหลือเพียงพอ
- เลือกประเภทงาน: text-to-video, image-to-video หรือ video task อื่นๆ ที่เอกสารทางการรองรับในปัจจุบัน
- คุณจะไม่ได้รับไฟล์วิดีโอทันทีหลังจากส่งงาน โดยปกติจะได้รับ task object หรือ task ID ก่อน
- รองานเสร็จสมบูรณ์ จากนั้นจึงอ่านที่อยู่ URL ผลลัพธ์หรือดาวน์โหลดผลลัพธ์
- หากล้มเหลว ให้ตรวจสอบสถานะงานและรายละเอียดข้อผิดพลาดก่อน อย่าเพิ่งตรวจสอบแค่ Key เพียงอย่างเดียว
เตรียมพารามิเตอร์
| รายการกำหนดค่า | วิธีตั้งค่า/กรอกข้อมูล |
|---|---|
| API Key | สร้างจากระบบหลังบ้านของ Runway; SDK ทางการจะอ่านค่าจาก <code>RUNWAYML_API_SECRET</code> โดยค่าเริ่มต้น |
| Task | text-to-video / image-to-video |
| Prompt | คำอธิบายเนื้อหาวิดีโอ |
| Ratio / Size | แนวนอน แนวตั้ง หรือขนาดที่กำหนด |
| Duration | ความยาววิดีโอ |
| Status | สอบถามสถานะงาน (Poll) เป็นระยะจนกว่าจะเสร็จสมบูรณ์ |
| การตั้งค่า | คำอธิบาย | คำแนะนำสำหรับมือใหม่ |
|---|---|---|
| API Key | ข้อมูลรับรองคำขอสำหรับ Runway API | บันทึกไว้ในตัวแปรสภาพแวดล้อม (Environment Variables) ของเครื่องหรือเซิร์ฟเวอร์เท่านั้น โดยใช้ชื่อตัวแปร RUNWAYML_API_SECRET |
| Prompt | คำอธิบายเนื้อหาวิดีโอ | เขียนให้สั้นก่อน แล้วค่อยปรับแต่งรายละเอียดหลังจากยืนยันสไตล์ได้แล้ว |
| Image | ภาพเริ่มต้นสำหรับ image-to-video | อัปโหลดภาพที่คมชัดและมีตัวแบบที่ชัดเจน |
| Duration | ความยาววิดีโอ (วินาที) | ทดสอบค่าใช้จ่ายและผลลัพธ์ด้วยความยาวที่สั้นก่อน |
| Status | สถานะงาน | การสร้างวิดีโอเป็นการทำงานแบบ Asynchronous ซึ่งจำเป็นต้องรอจนกว่าจะเสร็จสมบูรณ์ |
ตัวอย่าง SDK
ชื่อตัวแปรสภาพแวดล้อม Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYตัวอย่าง Runway Node.js Task
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }ฟิลด์ต่างๆ ของแพลตฟอร์มวิดีโอจะได้รับการอัปเดตตามเวอร์ชันของโมเดล ตัวอย่างในหน้านี้ใช้เพื่อทำความเข้าใจโครงสร้างการกำหนดค่า โปรดอ้างอิงฟิลด์จริงตามเอกสารทางการเวอร์ชันปัจจุบัน
| ปัญหาที่พบ | สิ่งที่ควรตรวจสอบก่อน | แนวทางแก้ไข |
|---|---|---|
| ไม่ได้รับวิดีโอกลับมาทันทีหลังจากส่งคำขอ | งานยังอยู่ในคิวหรือกำลังสร้างอยู่หรือไม่? | การสร้างวิดีโอเป็นงานแบบ Asynchronous ให้รอจนกว่าสถานะจะเสร็จสมบูรณ์ก่อนดึงผลลัพธ์ |
| งานล้มเหลว | ชื่อโมเดล อัตราส่วน ความยาว และภาพที่นำเข้าเป็นไปตามข้อกำหนดของโมเดลปัจจุบันหรือไม่ | ปรับพารามิเตอร์ตามรายละเอียดข้อผิดพลาดที่ส่งกลับมา และอย่าเปลี่ยนหลายรายการพร้อมกันในคราวเดียว |
| ค่าใช้จ่ายสูงกว่าที่คาดไว้ | ความยาว ความละเอียด เวอร์ชันของโมเดล | ทดสอบด้วยความยาวสั้นและพารามิเตอร์ที่ต้นทุนต่ำก่อน จากนั้นค่อยสร้างทีละมากๆ |