Seedance 2.5 Flash API
เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Seedance 2.5 Flash ของ ByteDance
รุ่นของโมเดล {#}
API นี้รองรับโมเดลสามรุ่นดังต่อไปนี้
ตารางเปรียบเทียบ
อัตราส่วนภาพที่รองรับ
การสร้างวิดีโอจากข้อความและจากสื่ออ้างอิงรองรับอัตราส่วนต่อไปนี้
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
การสร้างวิดีโอจากรูปภาพไม่รองรับพารามิเตอร์ aspect_ratio
ตัวเลือกความละเอียด
Seedance 2.5 Flash Text to Video
เอนด์พอยต์
POST /api/v1/video/task
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
ตัวอย่างคำขอ
javascript
Seedance 2.5 Flash Image to Video
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
อย่าใส่
aspect_ratioในคำขอสร้างวิดีโอจากรูปภาพ เนื่องจากโมเดลนี้ไม่รองรับพารามิเตอร์ดังกล่าว
ตัวอย่างคำขอ
javascript
Seedance 2.5 Flash Reference to Video
พารามิเตอร์คำขอ
จำเป็น
สื่ออ้างอิง
สื่ออ้างอิงทุกประเภทเป็นตัวเลือก สามารถส่งเฉพาะรูปภาพ เฉพาะวิดีโอ เฉพาะเสียง หรือไม่ส่งสื่ออ้างอิงเลยก็ได้ หากไม่มีสื่ออ้างอิง แนะนำให้ใช้โมเดลสร้างวิดีโอจากข้อความ
ตัวยึดตำแหน่งสำหรับอ้างอิงด้วย @ (AT)
ฟีเจอร์อ้างอิง @ (AT) เชื่อมสื่ออ้างอิงกับพรอมต์ผ่านตัวยึดตำแหน่ง <<<...>>> ที่มีหมายเลข แต่ละประเภทสื่อเริ่มนับจาก 1 แยกกันตามลำดับในอาร์เรย์ของประเภทนั้น
ตัวอย่างเช่น หากรูปแรกใช้อ้างอิงตัวละครและรูปที่สองใช้อ้างอิงฉาก ให้ใช้ <<<image_1>>> สำหรับตัวละครและ <<<image_2>>> สำหรับฉากใน prompt ตัวยึดตำแหน่งแต่ละตัวต้องชี้ไปยังรายการที่มีอยู่ในอาร์เรย์ที่ตรงกัน
ไม่บังคับ
ตัวอย่างคำขอ
javascript
ตัวอย่างคำขอสร้างวิดีโอจากสื่ออ้างอิงด้วย @ (AT)
javascript
ข้อจำกัดของสื่อ
ข้อจำกัดเหล่านี้ใช้กับรูปภาพเฟรมแรก รูปภาพเฟรมสุดท้าย และสื่ออ้างอิงของโมเดลในหน้านี้
เสียงอ้างอิงและวิดีโออ้างอิงมีความยาวรวมได้ประเภทละไม่เกิน 30 วินาที จำนวนรายการนับแยกกัน โดยใช้รูปภาพได้ไม่เกิน 10 รูป วิดีโอไม่เกิน 5 รายการ และคลิปเสียงไม่เกิน 5 คลิป
ทุกโมเดลต้องระบุ resolution และ duration ซึ่งไม่มีค่าเริ่มต้น หากไม่ระบุ aspect_ratio โมเดลสร้างวิดีโอจากข้อความและจากสื่ออ้างอิงจะใช้ 16:9 ตัวเลือกเสียงมีค่าเริ่มต้นเป็น true หากต้องการวิดีโอที่ไม่มีเสียง ให้ตั้งเป็น false
รูปแบบการตอบกลับ
การตอบกลับครั้งแรก
ทุกโมเดลส่งคืน task_id สำหรับสอบถามสถานะเป็นระยะ
json
การตอบกลับเมื่อสอบถามสถานะ
เรียก GET /api/v1/video/{taskId} เป็นระยะเพื่อตรวจสอบสถานะ
json
ค่าสถานะ
submitted: รับงานแล้วและกำลังรอประมวลผลprocessing: กำลังสร้างวิดีโอsucceed: สร้างวิดีโอเสร็จแล้วfailed: การสร้างวิดีโอล้มเหลว
ระยะเวลาประมวลผล
ระยะเวลาประมวลผลขึ้นอยู่กับความยาววิดีโอ ความละเอียด และสถานะคิวในขณะนั้น
สอบถามสถานะทุก 5–10 วินาที
แนวทางปฏิบัติที่แนะนำ
- พารามิเตอร์ที่จำเป็น: ระบุ
prompt,resolutionและdurationเสมอ ส่วนaspect_ratioเป็นตัวเลือกสำหรับการสร้างวิดีโอจากข้อความและจากสื่ออ้างอิง โดยมีค่าเริ่มต้นเป็น16:9 - อัตราส่วนภาพเมื่อสร้างวิดีโอจากรูปภาพ: อย่าส่ง
aspect_ratioในคำขอสร้างวิดีโอจากรูปภาพ - วิดีโออ้างอิง: ไม่จำเป็นต้องส่งวิดีโอ หากส่ง ความยาวของแต่ละวิดีโอและความยาวรวมต้องอยู่ในขีดจำกัดที่ระบุไว้
- รูปภาพอ้างอิง: จะส่งรูปภาพหรือไม่ก็ได้ ไม่ว่าจะมีวิดีโอหรือเสียงหรือไม่ โดยส่ง URL รูปภาพที่รองรับได้สูงสุด 10 รายการ
- เสียงอ้างอิง: คลิปเสียงแต่ละคลิปต้องยาว 2–30 วินาทีและไม่เกิน 15 MB โดยมีความยาวรวมไม่เกิน 30 วินาที
- ลำดับการอ้างอิง: เรียงรายการใน
images,videosและaudiosตามลำดับที่ต้องการ และอ้างถึงในพรอมต์ให้ตรงกับลำดับนั้น - เสียง: ไม่ต้องระบุ
soundหากต้องการใช้ค่าเริ่มต้นtrueหรือตั้งเป็นfalseเพื่อปิดการสร้างเสียง