Seedance 2.5 Flash API
Referensi API lengkap untuk model pembuat video Seedance 2.5 Flash dari ByteDance.
Varian model
API ini mendukung tiga varian model:
Perbandingan singkat
Rasio aspek yang didukung
Varian teks ke video dan referensi ke video mendukung rasio berikut:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Varian gambar ke video tidak mendukung parameter aspect_ratio.
Pilihan resolusi
Seedance 2.5 Flash Text to Video
Endpoint
POST /api/v1/video/task
Parameter permintaan
Wajib
Opsional
Contoh permintaan
javascript
Seedance 2.5 Flash Image to Video
Parameter permintaan
Wajib
Opsional
Jangan sertakan
aspect_ratiodalam permintaan gambar ke video. Model ini tidak mendukung parameter tersebut.
Contoh permintaan
javascript
Seedance 2.5 Flash Reference to Video
Parameter permintaan
Wajib
Media referensi
Semua media referensi bersifat opsional. Permintaan dapat menggunakan gambar saja, video saja, audio saja, atau tanpa media referensi. Untuk membuat video tanpa referensi, sebaiknya gunakan varian teks ke video.
Penanda referensi @ (AT)
Fitur referensi @ (AT) menghubungkan media referensi dengan prompt melalui penanda bernomor <<<...>>>. Penomoran dimulai dari 1 untuk setiap jenis media secara terpisah dan mengikuti urutan larik masing-masing:
Misalnya, jika gambar pertama merupakan referensi karakter dan gambar kedua merupakan referensi latar, gunakan <<<image_1>>> untuk karakter dan <<<image_2>>> untuk latar di dalam prompt. Setiap penanda harus merujuk ke elemen yang ada dalam larik terkait.
Opsional
Contoh permintaan
javascript
Contoh permintaan referensi ke video dengan @ (AT)
javascript
Batas media
Batas ini berlaku untuk gambar bingkai awal, gambar bingkai akhir, dan media referensi pada model di halaman ini.
Audio dan video referensi masing-masing memiliki batas durasi gabungan tersendiri, yaitu 30 detik. Batas jumlahnya juga terpisah: maksimal 10 gambar, 5 video, dan 5 klip audio.
Semua model mewajibkan resolution dan duration tanpa nilai bawaan. Jika aspect_ratio tidak disertakan, varian teks ke video dan referensi ke video menggunakan 16:9. Nilai bawaan untuk suara adalah true. Gunakan false untuk menghasilkan video tanpa suara.
Format respons
Respons awal
Semua model mengembalikan task_id untuk pemeriksaan status berkala:
json
Respons pemeriksaan status
Kirim permintaan GET /api/v1/video/{taskId} secara berkala untuk memeriksa status:
json
Nilai status
submitted: Tugas diterima dan menunggu untuk diprosesprocessing: Video sedang dibuatsucceed: Pembuatan video selesaifailed: Pembuatan video gagal
Waktu pemrosesan
Waktu pemrosesan bergantung pada durasi, resolusi, dan kondisi antrean saat ini.
Periksa status setiap 5–10 detik.
Praktik terbaik
- Parameter wajib: selalu sertakan
prompt,resolution, danduration. Untuk varian teks ke video dan referensi ke video,aspect_ratiobersifat opsional dengan nilai bawaan16:9 - Rasio gambar ke video: jangan kirim
aspect_ratiodalam permintaan gambar ke video - Video referensi: video bersifat opsional. Patuhi batas durasi yang ditetapkan untuk setiap video serta durasi gabungannya
- Gambar referensi: gambar bersifat opsional, terlepas dari penggunaan video dan audio. Kirim maksimal 10 URL gambar yang didukung
- Audio referensi: setiap klip audio harus berdurasi 2–30 detik dan berukuran maksimal 15 MB, dengan durasi gabungan maksimal 30 detik
- Urutan referensi: susun
images,videos, danaudiossesuai urutan yang diinginkan dan rujuk elemen-elemennya secara konsisten di dalam prompt - Suara: abaikan parameter
sounduntuk menggunakan nilai bawaantrue, atau tetapkan nilainya kefalseuntuk menonaktifkan pembuatan suara