doubao-seedance-2-0
Pembuatan Video doubao-seedance-2.0
- Mode pemrosesan asinkron, mengembalikan ID tugas untuk kueri berikutnya
- Mendukung teks-ke-video, gambar-ke-video (frame pertama/frame terakhir)
- Mendukung video referensi, audio referensi, dan video dengan audio
- Mendukung rasio aspek lanskap, potret, persegi, ultra-wide, dan adaptif
POST
Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Autentikasi
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:
Parameter Request
Nama model pembuatan videoModel yang didukung:
doubao-seedance-2.0- Versi standar, mendukung teks-ke-video, gambar-ke-video, video frame pertama/terakhir, video referensi, audio referensi, dan video dengan audiodoubao-seedance-2.0-fast- Versi cepat, fitur sama seperti versi standar dengan kecepatan pembuatan lebih tinggidoubao-seedance-2.0-face- Mendukung unggahan orang nyata, fitur sama seperti versi standardoubao-seedance-2.0-fast-face- Mendukung unggahan orang nyata, fitur sama seperti versi cepat
Deskripsi konten videoWajib untuk teks-ke-video; opsional untuk gambar-ke-video atau video-referensi-ke-videoDisarankan untuk menentukan subjek, aksi, gerakan kamera, dan gaya dengan jelas agar hasil pembuatan lebih baikContoh:
"A kitten yawning at the camera"Durasi video (detik)Rentang yang didukung:
4 hingga 15 detikDefault: 5Rasio aspek videoOpsi:
16:9- Lanskap9:16- Potret1:1- Persegi4:3- Rasio tradisional3:4- Rasio tradisional vertikal21:9- Ultra-wideadaptif- Adaptif (secara otomatis menyesuaikan dengan gambar/video input)
16:9Resolusi videoOpsi:
480p- Definisi standar720p- Definisi tinggi1080p- Full HD (hanya didukung olehdoubao-seedance-2.0-facedandoubao-seedance-2.0)
480pSeed acak untuk mengontrol keacakan konten yang dibuat
- Dengan request yang sama, nilai seed yang berbeda akan menghasilkan hasil berbeda
- Dengan request yang sama, nilai seed yang sama akan menghasilkan hasil mirip, tetapi konsistensi persis tidak dijamin
Apakah membuat audio (video dengan audio)Saat disetel ke
true, video akan menyertakan audio pengiring yang dibuat AIDefault: falseApakah mengembalikan gambar frame terakhirSaat disetel ke
true, hasil tugas juga akan mengembalikan URL gambar frame terakhir video, yang dapat digunakan untuk pembuatan video berkelanjutanDefault: falseDaftar tool untuk kemampuan tambahan seperti web searchContoh:
[{"type": "web_search"}]Array URL gambar untuk gambar-ke-videoMendukung dua format:
- URL gambar reguler:
https://example.com/cat.jpg - Asset URL (aset yang disetujui):
asset://asset_a
["https://example.com/cat.jpg"] atau ["asset://asset_a"]Asset URL hanya didukung oleh model
doubao-seedance-2.0 dan doubao-seedance-2.0-fast. Model lain tidak mendukungnya.Array gambar dengan role, mendukung penentuan frame pertama/frame terakhirContoh:Format Asset URL:
Jika field
url menggunakan Asset URL, hanya model doubao-seedance-2.0 dan doubao-seedance-2.0-fast yang didukung. Model lain tidak mendukungnya.Array URL video referensiMendukung dua format:
- URL video reguler:
https://example.com/reference.mp4 - Asset URL (aset yang disetujui):
asset://asset_a
["https://example.com/reference.mp4"] atau ["asset://asset_a"]Asset URL hanya didukung oleh model
doubao-seedance-2.0 dan doubao-seedance-2.0-fast. Model lain tidak mendukungnya.Array URL audio referensiMendukung dua format:
- URL audio reguler:
https://example.com/speech.wav - Asset URL (aset yang disetujui):
asset://asset_a
["https://example.com/speech.wav"] atau ["asset://asset_a"]Asset URL hanya didukung oleh model
doubao-seedance-2.0 dan doubao-seedance-2.0-fast. Model lain tidak mendukungnya.Respons
Kode status respons, 200 jika berhasil
Array data respons
Kasus Penggunaan
Kasus 1: Teks-ke-Video
Kasus 2: Gambar-ke-Video (Frame Pertama)
Kasus 3: Video Frame Pertama/Terakhir
Kasus 4: Video-Referensi-ke-Video
Kasus 5: Video Referensi + Audio Referensi
Kasus 6: Video dengan Audio
Kasus 7: Pembuatan Video Berkelanjutan (Mengembalikan Frame Terakhir)
Kasus 8: Pembuatan Versi Cepat
Kasus 9: Gambar Referensi + Video Referensi + Audio Referensi (Video Multimodal)
Gabungkan gambar referensi, video referensi, dan audio referensi untuk menghasilkan video iklan perspektif orang pertama yang imersif. Ideal untuk promosi produk, iklan brand, dan skenario lain yang memerlukan fusi materi dari beberapa sumber.Kasus 10: Gambar-ke-Video dengan Asset URL
Aset avatar virtual yang disetujui dapat diteruskan langsung sebagai gambar referensi tanpa perlu diunggah ulang atau direview ulang.Kasus 11: Tentukan Potret Referensi dengan Asset URL (image_with_roles)
Kasus 12: Versi Cepat + Gambar-ke-Video Asset URL
Kasus 13: Gambar Asset URL + Video Referensi (Transfer Gerakan)
Gabungkan aset potret yang disetujui dengan video referensi untuk menggerakkan karakter melakukan gerakan tertentu.Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan
task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.Perbedaan dari Versi 1.5 Pro
| Fitur | 1.5 Pro | 2.0 / 2.0 fast |
|---|---|---|
| Resolusi | 480p/720p/1080p | 480p/720p |
| Rentang durasi | 4-12s | 5-15s |
| Durasi default | 5s | 5s |
| Parameter rasio aspek | aspect_ratio | size (opsi adaptive baru) |
| Pembuatan audio | parameter audio | parameter generate_audio |
| Video referensi | Tidak didukung | Didukung melalui video_urls |
| Audio referensi | Tidak didukung | Didukung melalui audio_urls |
| Gambar-ke-video | image_urls / image_with_roles | image_urls / image_with_roles |
| Video dengan audio | Tidak didukung | Didukung melalui generate_audio |
| Video berkelanjutan | Tidak didukung | Didukung melalui return_last_frame |
| Versi cepat | Tidak didukung | Didukung melalui doubao-seedance-2.0-fast |