Skip to main content
POST

Autentikasi

string
wajib
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

string
wajib
Nama model pembuatan videoModel yang didukung:
  • seedance-2.0 - Versi standar, mendukung teks-ke-video, gambar-ke-video, video frame pertama/terakhir, video referensi, audio referensi, dan video dengan audio
  • seedance-2.0-fast - Versi cepat, fitur sama seperti versi standar dengan kecepatan pembuatan lebih tinggi
  • seedance-2.0-mini - Versi mini, fitur sama seperti versi standar
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
Konten yang diperiksa:
  • Teks: prompt, negative_prompt
  • Gambar: image_urls, image_with_roles[].url, first_frame_image, last_frame_image
  • Aset privat gambar asset://: temukan lalu periksa URL publik aslinya
  • Gambar Base64: periksa setelah dikonversi menjadi URL publik
video_urls, audio_urls, serta aset privat video/audio tidak diperiksa, karena model moderasi tidak mendukung video atau audio.ID model yang didukung: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (nama lama), dan seedance-2.5.Panggilan moderasi itu sendiri tidak ditagihkan kepada pengguna yang mengirim permintaan video.
  • Konten yang terdeteksi mengembalikan HTTP 400 (nsfw_content_detected) secara sinkron. Tugas dan task_id tidak dibuat, serta kuota pembuatan video tidak dipotong
  • Jika moderasi tidak tersedia, mengalami timeout, atau mengembalikan respons yang tidak valid, sistem menggunakan fail-open dan pembuatan video dilanjutkan. Opsi ini bukan jaminan mutlak keamanan konten
  • Input yang tidak dapat diubah menjadi URL gambar publik akan dilewati; model yang tidak didukung mengabaikan nsfw_check: true tanpa pemberitahuan
Contoh:
Respons saat terdeteksi:
string
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 baik
  • Prompt dibatasi hingga 4000 karakter, tetapi 500 karakter direkomendasikan.
  • Model seedance-2.0-mini tidak memiliki batasan jumlah karakter. Rekomendasi: prompt dalam bahasa Tionghoa sebaiknya tidak lebih dari 500 karakter dan prompt dalam bahasa Inggris tidak lebih dari 1000 kata. Teks yang terlalu panjang cenderung membuat informasi tersebar, dan model dapat mengabaikan detail serta hanya fokus pada poin utama, sehingga menyebabkan beberapa elemen hilang dalam video.
Contoh: "A kitten yawning at the camera"
integer
default:"5"
Durasi video (detik)Rentang yang didukung: 4 hingga 15 detikDefault: 5
string
default:"16:9"
Rasio aspek videoRasio aspek harus antara 0.5 dan 2.5Opsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Rasio tradisional
  • 3:4 - Rasio tradisional vertikal
  • 21:9 - Ultra-wide
  • adaptif - Adaptif (secara otomatis menyesuaikan dengan gambar/video input)
Default: 16:9
string
default:"720p"
Resolusi videoOpsi:
  • 480p - Definisi standar
  • 720p - Definisi tinggi
  • 1080p - Full HD (hanya didukung oleh seedance-2.0)
  • 4k - Ultra HD (hanya didukung oleh seedance-2.0)
Default: 720p
integer
Seed 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
boolean
default:"true"
Apakah membuat audio (video dengan audio)Saat disetel ke true, video akan menyertakan audio pengiring yang dibuat AISaat disetel ke false, video tidak akan menyertakan audio (video tanpa suara)Default: true
boolean
default:"false"
Apakah mengembalikan gambar frame terakhirSaat disetel ke true, hasil tugas juga akan mengembalikan URL gambar frame terakhir video, yang dapat digunakan untuk pembuatan video berkelanjutanDefault: false
array<object>
Daftar tool untuk kemampuan tambahan seperti web searchContoh: [{"type": "web_search"}]
array<string>
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
Contoh: ["https://example.com/cat.jpg"] atau ["asset://asset_a"]
Asset URL didukung oleh semua model Seedance 2.0: seedance-2.0, seedance-2.0-fast, dan seedance-2.0-mini.
  • image_urls dan image_with_roles tidak dapat digunakan bersamaan
  • Maximum of 9 reference images
array
Array gambar dengan role, mendukung penentuan frame pertama/frame terakhir
Jika field url menggunakan Asset URL, semua model Seedance 2.0 didukung: seedance-2.0, seedance-2.0-fast, dan seedance-2.0-mini.
Contoh:
Format Asset URL:
  • image_urls dan image_with_roles tidak dapat digunakan bersamaan
  • Saat menggunakan gambar frame pertama/frame terakhir, video_urls dan audio_urls tidak tersedia
array<string>
Array URL video referensiMendukung dua format:
  • URL video reguler: https://example.com/reference.mp4
  • Asset URL (aset yang disetujui): asset://asset_a
Contoh: ["https://example.com/reference.mp4"] atau ["asset://asset_a"]
Asset URL didukung oleh semua model Seedance 2.0: seedance-2.0, seedance-2.0-fast, dan seedance-2.0-mini.
  • Saat menggunakan gambar frame pertama/frame terakhir (image_with_roles), video referensi tidak tersedia
  • Maksimum 3 video referensi, 1.8s < total durasi < 15.2s
  • Resolusi video referensi harus antara 480P dan 720P
array<string>
Array URL audio referensiMendukung dua format:
  • URL audio reguler: https://example.com/speech.wav
  • Asset URL (aset yang disetujui): asset://asset_a
Contoh: ["https://example.com/speech.wav"] atau ["asset://asset_a"]
Asset URL didukung oleh semua model Seedance 2.0: seedance-2.0, seedance-2.0-fast, dan seedance-2.0-mini.
  • Saat menggunakan gambar frame pertama/frame terakhir (image_with_roles), audio referensi tidak tersedia
  • Maksimum 3 file audio referensi, total durasi harus 15 dtk atau kurang
  • Audio referensi harus digunakan bersama gambar referensi atau video referensi

Respons

integer
Kode status respons, 200 jika berhasil
array
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