Pembuatan video Seedance 2.0

Verifikasi pemilik dan aset potret. Keempat model memakai antarmuka APIMaster yang sama. Backend memetakan endpoint, kredensial, ID, dan status penyedia. Verifikasi resmi pemilik, pemeriksaan potret oleh kanal, serta aset biasa atau virtual merupakan alur berbeda. Gunakan hanya foto dengan izin tegas dari pemilik.

Seedance 2.0 mendukung pembuatan teks-ke-video, gambar-ke-video, dan media referensi melalui tugas asinkron.

URL Dasar: https://apimaster.ai/v1 adalah https://apimaster.ai/v1. Jangan tambahkan /v1 lagi ke path.

Batas durasi (diverifikasi 2026-10-06)

Untuk kompatibilitas lintas kanal, tentukan 4–15 detik secara eksplisit pada Seedance 2.0. Beberapa rute tidak mendukung duration: -1; durasi otomatis penyedia asal tidak tersedia pada semua rute. duration: 20 melebihi batas; mencoba ulang tidak menyelesaikannya.

Maksimal 3 video referensi, masing-masing 2–15 detik dengan total maksimal 15 detik; audio referensi memiliki batas jumlah dan durasi yang sama. Batas masukan dan keluaran terpisah. Detik tertagih dapat mencakup keduanya, tetapi tidak menambah batas keluaran.

Periksa parameter sebelum mengirim. HTTP 200 dan task_id hanya mengonfirmasi penerimaan; HTTP 400 / InvalidParameter berikutnya dapat membuat tugas gagal. Baca galat tugas, perbaiki parameter, lalu buat tugas baru. Jangan mengulang permintaan tanpa perubahan. Tugas gagal mengembalikan dana reservasi generasi.

Sumber verifikasi: Seedance API.

Kompatibilitas dan validasi

POST https://apimaster.ai/v1/video/generations dan POST https://apimaster.ai/v1/videos/generations didukung. Untuk model yang sama, parameter dan penagihan identik; setiap endpoint mempertahankan format respons pembuatan sebelumnya. Klien lama dapat tetap memakai jalurnya.

Untuk Seedance, ratio dan aspect_ratio adalah alias; resolusi yang tidak diisi memakai 720p. Nilai yang tidak didukung atau alias yang bertentangan menghasilkan HTTP 400, tanpa beralih diam-diam ke resolusi lebih tinggi. Isi resolusi, rasio, dan durasi secara eksplisit.

Parameter

Kolom	Tipe	Wajib	Deskripsi
model	string	ya	seedance-2.0
prompt	string	ya	Deskripsi video
duration	integer	tidak	duration adalah panjang video keluaran dalam detik: bilangan bulat dari 4 hingga 15.
resolution	string	tidak	480p, 720p, 1080p, atau 4K
aspect_ratio	string	tidak	16:9, 4:3, 1:1, 3:4, 9:16, 21:9, atau adaptive
image_urls	string[]	tidak	URL gambar referensi publik
video_urls	string[]	tidak	URL video referensi publik
audio_urls	string[]	tidak	URL audio referensi publik
generate_audio	boolean	tidak	Hasilkan audio
watermark	boolean	tidak	Tambahkan tanda air
seed	integer	tidak	Seed untuk reproduktifitas
output_format	string	tidak	mp4 atau mov

Kirim tugas

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "Sunlight through a forest, smooth forward camera movement",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false
  }'

Respons berisi task_id:

{"code":200,"data":[{"status":"submitted","task_id":"task_xxxxxxxx"}]}

Polling dan unduh

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" -H "Authorization: Bearer YOUR_API_KEY" -o output.mp4

Status mencakup submitted, in_progress, completed, dan failed. Unduh segera setelah selesai.

Penagihan

• Tanpa video referensi: biaya = detik tertagih video hasil × tarif efektif resolusi keluaran.
• Dengan video referensi: biaya = (jumlah detik tertagih semua video referensi + detik tertagih hasil) × tarif tingkat dengan masukan video untuk resolusi tersebut. Jangan hanya menghitung durasi keluaran atau memakai tarif tanpa masukan video.
• Contohnya, referensi 4 detik dan hasil 5 detik diperkirakan sebagai 9 detik tertagih. Gambar dan audio referensi tidak menambah detik video.

Pengiriman mencadangkan biaya yang mencakup durasi referensi terverifikasi dan durasi hasil yang diminta; durasi otomatis atau batas pencadangan memakai perkiraan maksimum yang berlaku. Setelah berhasil, pekerjaan tertagih aktual dari penyedia diselesaikan dengan biaya tambahan atau pengembalian selisih. Cadangan bisa berbeda dari biaya akhir. Tugas gagal mengembalikan cadangan pembuatan video.

Periksa kartu model dan Video/media pricing di dompet. Resolusi, tingkat masukan dan tarif akun memengaruhi harga. Biaya akhir adalah jumlah bersih cadangan, biaya tambahan dan pengembalian dana.

Kesalahan

400 parameter tidak valid, 401 kunci API tidak valid, 402 saldo tidak mencukupi, 429 dibatasi rate, dan 500/502 kesalahan layanan sementara.

Lihat juga: Ikhtisar pembuatan video dan Seedance 2.5.

Penawaran Seedance dan tanda terima penagihan

Penawaran Seedance dan tanda terima penagihan

Webhook tugas asinkron

Webhook tugas asinkron

Idempotensi Seedance dan pemulihan pengiriman