Seedance 2.0 API
เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Seedance 2.0 ของ ByteDance
รุ่นของโมเดล {#}
API นี้รองรับโมเดลหกรุ่น:
เปรียบเทียบโดยย่อ
อัตราส่วนภาพที่รองรับ
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
ตัวเลือกความละเอียด
Seedance 2.0 ข้อความเป็นวิดีโอ
จุดเชื่อมต่อ
POST /api/v1/video/task
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
ตัวอย่างคำขอ
javascript
Seedance 2.0 ภาพเป็นวิดีโอ
พารามิเตอร์คำขอ
จำเป็น
ไม่บังคับ
ตัวอย่างคำขอ
javascript
Seedance 2.0 สื่ออ้างอิงเป็นวิดีโอ
พารามิเตอร์คำขอ
จำเป็น
สื่ออ้างอิง
ส่งภาพ 1-9 ภาพ สามารถละเว้นภาพได้เฉพาะเมื่อมีวิดีโออ้างอิงอย่างน้อยหนึ่งรายการเท่านั้น
ตัวแทนค่าอ้างอิง @ (AT)
ฟีเจอร์อ้างอิง @ (AT) เชื่อมสื่ออ้างอิงกับพรอมต์ผ่านตัวแทนค่า <<<...>>> ที่มีหมายเลข การนับเริ่มจาก 1 แยกตามประเภทสื่อ และเรียงตามอาร์เรย์ที่เกี่ยวข้อง:
ตัวอย่างเช่น หากภาพแรกเป็นตัวละครอ้างอิงและภาพที่สองเป็นฉากอ้างอิง ให้ใช้ <<<image_1>>> สำหรับตัวละครและ <<<image_2>>> สำหรับฉากใน prompt ตัวแทนค่าแต่ละตัวต้องชี้ไปยังรายการที่มีอยู่จริงในอาร์เรย์ที่เกี่ยวข้อง
ไม่บังคับ
ตัวอย่างคำขอ
javascript
ตัวอย่างคำขอสื่ออ้างอิงเป็นวิดีโอด้วย @ (AT)
javascript
รุ่น Fast
รุ่น Fast ให้ความสำคัญกับความเร็วในการประมวลผล โมเดล Fast ทุกรุ่นรองรับเอาต์พุตเฉพาะ "480p" และ "720p" โครงสร้างคำขอส่วนอื่นของ Fast ข้อความเป็นวิดีโอและ Fast ภาพเป็นวิดีโอเหมือนกับโมเดลมาตรฐานที่ตรงกัน ส่วน Fast สื่ออ้างอิงเป็นวิดีโอใช้ข้อจำกัดสื่ออ้างอิงเดียวกับโมเดลอ้างอิงมาตรฐาน
ตัวอย่างคำขอ Fast
javascript
ตัวอย่างคำขอ Fast สื่ออ้างอิงเป็นวิดีโอด้วย @ (AT)
javascript
พารามิเตอร์ Seedance 2.0 Fast สื่ออ้างอิงเป็นวิดีโอ
จำเป็น
สื่ออ้างอิง
กฎตัวแทนค่าที่เริ่มนับจาก 1 ข้างต้นใช้กับโมเดล Fast สื่ออ้างอิงเป็นวิดีโอด้วย
ไม่บังคับ
ข้อจำกัดสื่อ
ข้อจำกัดเหล่านี้ใช้กับภาพเฟรมแรก ภาพเฟรมสุดท้าย และสื่ออ้างอิงของโมเดลในหน้านี้
เสียงอ้างอิงและวิดีโออ้างอิงมีขีดจำกัดความยาวรวมแยกกันประเภทละ 15 วินาที จำนวนแต่ละประเภทเป็นอิสระ: ภาพสูงสุด 9 ภาพ วิดีโอ 3 รายการ และเสียง 3 คลิป การเพิ่มวิดีโอไม่ลดจำนวนภาพที่อนุญาต
โมเดลทุกรุ่นมีค่าเริ่มต้นเป็น 720p แต่ยังต้องระบุ resolution สวิตช์เสียงมีค่าเริ่มต้นเป็น true โดยทั้งสวิตช์นี้และเสียงอ้างอิงไม่ทำให้ราคาเปลี่ยน สื่ออ้างอิงเป็นวิดีโอต้องมีภาพหรือวิดีโออย่างน้อยหนึ่งรายการ และไม่รองรับคำขอที่มีเฉพาะเสียง การอัปโหลดวิดีโออ้างอิงจะเพิ่มค่าบริการสร้างเป็นสองเท่า ไม่ว่าจำนวนหรือความยาวจะเท่าใด
รูปแบบการตอบกลับ
การตอบกลับเริ่มต้น
โมเดลทุกรุ่นส่งคืน task_id สำหรับตรวจสอบเป็นระยะ:
json
การตอบกลับจากการตรวจสอบ
เรียก GET /api/v1/video/{taskId} เป็นระยะเพื่อตรวจสอบสถานะ:
json
ค่าสถานะ
submitted: รับงานแล้วและกำลังรอประมวลผลprocessing: กำลังสร้างวิดีโอsucceed: สร้างวิดีโอเสร็จแล้วfailed: สร้างวิดีโอไม่สำเร็จ
เวลาประมวลผล
โมเดลมาตรฐาน: 3-8 นาที ขึ้นอยู่กับความยาวและความละเอียด
โมเดล Fast: 1-4 นาที สำหรับการตั้งค่าส่วนใหญ่
ตรวจสอบสถานะทุก 5-10 วินาที
แนวทางปฏิบัติที่แนะนำ
- เลือกรุ่นที่เหมาะสม: ใช้โมเดล Fast สำหรับทดลองปรับ และโมเดลมาตรฐานสำหรับผลลัพธ์สุดท้าย
- อธิบายการเคลื่อนไหวให้ชัดเจน: ระบุรายละเอียดการเคลื่อนไหวที่เฉพาะเจาะจงในพรอมต์
- เลือกความละเอียด: โมเดล Seedance 2.0 มาตรฐานทุกรุ่นรองรับ
480p,720p,1080pและ4k; โมเดล Fast ทุกรุ่นรองรับเฉพาะ480pและ720p - ลำดับสื่ออ้างอิง: จัด
images,videosและaudiosตามลำดับที่ตั้งใจ และอ้างอิงให้สอดคล้องกันในพรอมต์ - คำขอที่มีเฉพาะวิดีโอ: ใช้อาร์เรย์
imagesว่างเฉพาะเมื่อมีวิดีโออ้างอิงอย่างน้อยหนึ่งรายการ - ความยาวสื่อ: ให้เสียงและวิดีโออ้างอิงแต่ละรายการมีความยาว 2 ถึง 15 วินาที
- การใช้เสียง: ละเว้น
soundเพื่อใช้ค่าเริ่มต้นtrueหรือตั้งเป็นfalseเพื่อปิดการสร้างเสียง