Skip to main content
POST

Otorisasi

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-1-5-pro - Versi 1.5 Pro, mendukung pembuatan audio dan frame pertama/frame terakhir
string
wajib
Deskripsi konten videoJelaskan adegan, aksi, dan gaya secara detail untuk hasil pembuatan yang lebih baikContoh: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
integer
default:"5"
Durasi video (detik)Rentang yang didukung: 4 ~ 12 detikDefault: 5
string
default:"16:9"
Rasio aspek videoOpsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Rasio tradisional
  • 3:4 - Rasio tradisional vertikal
  • 21:9 - Ultra-wide
Default: 16:9
string
default:"720p"
Resolusi videoOpsi:
  • 480p - Definisi standar
  • 720p - Definisi tinggi
  • 1080p - Full HD
Default: 720p
integer
Bilangan bulat seed untuk mengontrol keacakan konten yang dibuatRentang nilai: bilangan bulat antara -1 dan 2^32-1
  • Dengan request yang sama, jika model menerima nilai seed berbeda (misalnya tidak menentukan seed atau menyetel seed ke -1, yang akan menggunakan angka acak), hasil yang berbeda akan dibuat
  • Dengan request yang sama, jika model menerima nilai seed yang sama, hasil yang mirip akan dibuat, tetapi tidak dijamin identik
boolean
default:"true"
Apakah membuat audioSaat disetel ke true, video akan menyertakan audio pengiring yang dibuat AIDefault: true
Pembuatan audio hanya didukung oleh seri Seedance 2.0 dan Seedance 1.5 Pro
boolean
default:"false"
Apakah mengunci kameraSaat disetel ke true, posisi kamera tetap terkunciDefault: false

Kombinasi Resolusi dan Rasio Aspek

array<url>
Array URL gambar untuk pembuatan gambar-ke-videoAturan penetapan role otomatis:
  • 1 gambar = frame pertama
  • 2 gambar = frame pertama + frame terakhir
Contoh: ["https://example.com/first.png", "https://example.com/last.png"]
  • image_urls dan image_with_roles tidak dapat digunakan bersamaan
array
Array gambar dengan role untuk kontrol yang lebih presisiContoh:
  • image_urls dan image_with_roles tidak dapat digunakan bersamaan
  • Frame pertama dan frame terakhir masing-masing hanya mendukung satu gambar

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Kasus Penggunaan

Kasus 1: Teks-ke-Video dengan Audio

Kasus 2: Video Pendek Potret Berkualitas Tinggi

Kasus 3: Frame Pertama ke Video Dinamis

Kasus 4: Efek Transisi dengan Frame Pertama/Terakhir

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.0