Seedance 2.0 API
Referensi API lengkap untuk model pembuatan video Seedance 2.0 dari ByteDance.
Varian Model
API ini mendukung enam varian model:
Perbandingan Singkat
Rasio Aspek yang Didukung
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Pilihan Resolusi
Seedance 2.0 Teks ke Video
Titik Akhir
POST /api/v1/video/task
Parameter Permintaan
Wajib
Opsional
Contoh Permintaan
javascript
Seedance 2.0 Gambar ke Video
Parameter Permintaan
Wajib
Opsional
Contoh Permintaan
javascript
Seedance 2.0 Referensi ke Video
Parameter Permintaan
Wajib
Media Referensi
Kirim 1-9 gambar. Gambar hanya boleh dihilangkan jika setidaknya satu video referensi disediakan.
Penanda Referensi @ (AT)
Fitur referensi @ (AT) menghubungkan media referensi ke prompt melalui penanda bernomor <<<...>>>. Penomoran dimulai dari 1 secara terpisah untuk setiap jenis media dan mengikuti urutan array terkait:
Misalnya, jika gambar pertama adalah referensi karakter dan gambar kedua adalah referensi adegan, gunakan <<<image_1>>> untuk karakter dan <<<image_2>>> untuk adegan dalam prompt. Setiap penanda harus menunjuk ke item yang ada dalam array terkait.
Opsional
Contoh Permintaan
javascript
Contoh Permintaan Referensi ke Video dengan @ (AT)
javascript
Varian Fast
Varian Fast mengutamakan kecepatan pemrosesan. Semua model Fast hanya mendukung keluaran "480p" dan "720p". Struktur permintaan Fast Teks ke Video dan Fast Gambar ke Video lainnya mengikuti model standar masing-masing, sedangkan Fast Referensi ke Video menggunakan batas media referensi yang sama dengan model referensi standar.
Contoh Permintaan Fast
javascript
Contoh Permintaan Fast Referensi ke Video dengan @ (AT)
javascript
Parameter Seedance 2.0 Fast Referensi ke Video
Wajib
Media Referensi
Aturan penanda yang dimulai dari 1 di atas juga berlaku untuk model Fast Referensi ke Video.
Opsional
Batas Media
Batas ini berlaku untuk gambar bingkai pertama, gambar bingkai terakhir, dan media referensi model pada halaman ini.
Audio referensi dan video referensi masing-masing memiliki batas total durasi terpisah sebesar 15 detik. Jumlahnya independen: maksimal 9 gambar, 3 video, dan 3 klip audio. Menambahkan video tidak mengurangi jumlah gambar yang diizinkan.
Semua model menggunakan 720p secara bawaan, tetapi resolution tetap wajib diberikan. Sakelar suara bernilai bawaan true; baik sakelar ini maupun audio referensi tidak mengubah harga. Referensi ke Video memerlukan setidaknya satu gambar atau video; permintaan yang hanya berisi audio tidak didukung. Mengunggah video referensi menggandakan biaya pembuatan, terlepas dari jumlah atau durasinya.
Format Respons
Respons Awal
Semua model mengembalikan task_id untuk pemeriksaan berkala:
json
Respons Pemeriksaan Berkala
Periksa GET /api/v1/video/{taskId} secara berkala untuk mengetahui status:
json
Nilai Status
submitted: tugas diterima dan menunggu pemrosesanprocessing: pembuatan video sedang berlangsungsucceed: pembuatan video selesaifailed: pembuatan video gagal
Waktu Pemrosesan
Model Standar: 3-8 menit, tergantung durasi dan resolusi.
Model Fast: 1-4 menit untuk sebagian besar konfigurasi.
Periksa status setiap 5-10 detik.
Praktik Terbaik
- Pilih Varian yang Tepat: gunakan model Fast untuk iterasi dan model standar untuk hasil akhir
- Jelaskan Gerakan dengan Jelas: sertakan deskripsi gerakan spesifik dalam prompt
- Pemilihan Resolusi: semua model Seedance 2.0 standar mendukung
480p,720p,1080p, dan4k; semua model Fast hanya mendukung480pdan720p - Urutan Referensi: susun
images,videos, danaudiossesuai tujuan dan rujuk secara konsisten dalam prompt - Permintaan Hanya Video: gunakan array
imageskosong hanya jika setidaknya satu video referensi disediakan - Durasi Media: pastikan setiap audio dan video referensi berdurasi antara 2 dan 15 detik
- Pemanfaatan Audio: hilangkan
sounduntuk memakai nilai bawaantrue, atau atur kefalseuntuk menonaktifkan suara yang dihasilkan