Langsung ke konten utama
POST
Kirim melalui POST /v1/videos/generations, baca data[0].task_id, lalu periksa GET /v1/tasks/{task_id}.
string
wajib
Gunakan Authorization: Bearer <token>, dengan <token> sebagai API key APIMart Anda.

Parameter permintaan

string
wajib
Gunakan seedance-2-5-flash. Alias doubao-seedance-2-5-flash juga diterima. Nama bertitik seedance-2.5-flash tidak didukung.
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 terdeteksi menghasilkan HTTP 400 (nsfw_content_detected) tanpa membuat tugas atau biaya generasi. Video dan audio referensi tidak diperiksa. Permintaan dapat berlanjut jika layanan moderasi gagal.
string
wajib
Prompt wajib. Rujuk media menggunakan @图片1 / @视频1 / @音频1; indeks mulai dari 1 sesuai urutan masing-masing array media.
string
default:"720p"
Hanya 480p / 720p, default 720p. 1080p, 2k, 4k, atau nilai lain menghasilkan HTTP 400 saat pengiriman.
string
default:"adaptive"
Mendukung 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (default). Alias: aspect_ratio. Tugas frame awal/akhir, edit, dan extend wajib memakai adaptive.
integer
Detik bulat 4–30; permintaan biasa memakai 5 jika dihilangkan. -1 berarti otomatis. edit eksplisit hanya menerima -1 atau dihilangkan, yang diperlakukan sebagai -1; durasi mengikuti video sumber. Durasi otomatis mencadangkan 30 detik lalu dihitung berdasarkan token aktual.
boolean
default:"true"
Buat suara, default true. Alias: audio. Mengatur suara keluaran, terpisah dari input referensi audio_urls.
boolean
default:"false"
Tambahkan watermark buatan AI, default false.
integer
Seed acak opsional. Seed yang sama tidak menjamin hasil identik.
string
default:"mp4"
Kontainer keluaran: mp4 (default) atau mov.
string
default:"auto"
auto (default), reference, edit, atau extend, hanya untuk tugas dengan media referensi. Jenis eksplisit memicu validasi saat pengiriman sesuai tabel di bawah.
string[]
Array gambar referensi, semuanya sebagai reference_image. Maksimal 10 gambar digabung dengan image_with_roles. Gunakan image_with_roles untuk frame awal/akhir.
object[]
Setiap item memuat url dan role. Peran: reference_image, first_frame (maksimal 1), last_frame (maksimal 1, bersama frame awal). Total maksimal 10 bersama image_urls; hindari peran yang bertentangan. Jika ada video_urls / audio_urls, frame awal/akhir menjadi gambar referensi multimodal.
string[]
Maksimal 5 video, masing-masing 2–30 detik, total maksimal 30 detik. Video sumber untuk edit harus berdurasi 4–30 detik.
string[]
Maksimal 5 audio, masing-masing 2–30 detik, total maksimal 30 detik. Referensi hanya audio didukung, tanpa harus menyertakan gambar atau video.
boolean
default:"false"
Jika true, gambar frame terakhir dikembalikan setelah berhasil di data.result.videos[].last_frame_url.
Izinkan model mencari di web jika diperlukan, default false.
object[]
Daftar alat opsional, misalnya [{"type":"web_search"}] untuk pencarian web.
draft / draft_task_id tidak didukung; hapus dari permintaan agar tidak mendapat HTTP 400. Gunakan Seedance 2.5 untuk mode draf.

Persyaratan media

Gunakan URL http(s) yang dapat diakses publik atau ID asset:// yang sudah disetujui. Resolusi keluaran dan batas piksel video input diperiksa secara terpisah.

Jenis tugas dan batasan

Pelanggaran batas jenis eksplisit menghasilkan HTTP 400 sebelum tugas dibuat atau biaya dikenakan. Dengan auto, model menentukan jenis dari media dan prompt sehingga dapat gagal saat generasi. Jenis eksplisit pun dapat mengalami InvalidParameter.TaskTypeMismatch jika bertentangan dengan prompt.

Contoh permintaan

Referensi multimodal

Frame awal dan akhir

Edit video

Perpanjang video

Aset privat

Gambar atau video yang berisi wajah orang nyata harus disetujui di pustaka aset sebelum memakai asset://. Saat mengunggah, isi juga model dengan seedance-2-5-flash. Lihat API pustaka aset dan gunakan nama Flash pada contoh berikut.
Periksa tugas peninjauan aset melalui API tugas terpadu. Setelah disetujui, ambil ID asset:// dari daftar aset lalu pakai pada image_urls, image_with_roles[].url, video_urls, atau audio_urls.

Status dan hasil tugas

Lakukan polling API status tugas. pending / processing berarti berjalan, completed berhasil, failed gagal. Baca data.result.videos[0].url[0]; url berupa array.

Penagihan

  • Saat dikirim, dana dicadangkan berdasarkan tarif per detik sesuai resolusi. Referensi video memakai tingkat dengan input: durasi keluaran ditambah total durasi video referensi.
  • Permintaan biasa tanpa duration mencadangkan 5 detik keluaran. duration: -1, atau edit tanpa durasi, mencadangkan 30 detik keluaran.
  • Setelah berhasil: data.usage.completion_tokens ÷ 1,000,000 × tarif per juta token yang sesuai, dengan diskon akun. Selisih dikembalikan atau ditagihkan. Ada tidaknya referensi video menentukan token atau token-input; biaya akhir ada pada data.cost.
  • Pengiriman yang ditolak tidak dikenai biaya generasi. Jika generasi gagal, dana cadangan dikembalikan. Tarif dan diskon tersedia di halaman harga.

Kesalahan umum