Panduan Akses dan Harga API Doubao Seedance 2.5

Jika saya menilai Seedance 2.5 hari ini, saya akan berfokus pada tiga hal terlebih dahulu: akses masih terbatas, harga masih sebagian berbasis perkiraan, dan penyiapannya terutama menggunakan alur tugas video asinkron.

Berikut versi singkatnya:

• Saya dapat memperoleh akses API melalui BytePlus ModelArk di luar Tiongkok daratan, Volcano Engine Ark di Tiongkok daratan, atau APIMart untuk alur klien bergaya OpenAI.
• Saya perlu memperkirakan penagihan USD di BytePlus dan APIMart, serta penagihan CNY di Volcano Engine Ark.
• Harga publik Seedance 2.5 belum sepenuhnya tersedia, sehingga sebagian besar perencanaan biaya saat ini memakai tarif referensi Seedance 2.0 seperti $0.092/detik untuk 480p dan $0.199/detik untuk 720p.
• Pemeriksaan anggaran sederhana adalah: detik × tarif per detik. Dengan sekitar $0.20/detik, klip 10 detik kira-kira berharga $2.00, sedangkan klip 30 detik sekitar $6.00.
• Integrasinya sederhana: kirim tugas → polling status setiap 8–15 detik → unduh saat selesai.
• Daya tarik utama model ini adalah input multimodal dalam satu alur, dengan hingga 50 aset referensi, ditambah video, audio, dan kontrol edit dalam proses yang sama.

Dengan kata lain, Seedance 2.5 cocok jika saya sudah memiliki sistem tugas backend dan memerlukan pembuatan video pendek yang terpandu. Namun, sebelum menyusun anggaran atau meluncurkannya, saya akan memeriksa akses model langsung, ID model saat ini, dan harga aktual di konsol.

Panduan lengkap integrasi API Seedance 2.5

Perbandingan singkat

Bagian berikut membahas hal yang paling penting bagi saya: cara mendapatkan akses, perkiraan biaya sebuah klip, dan cara memasangnya ke aplikasi tanpa membuang waktu atau anggaran;

1. Fitur yang ditawarkan Doubao Seedance 2.5

Kemampuan inti video dan multimodal

Seedance 2.5 menggabungkan beberapa peningkatan besar dalam satu proses: hasil 4K native, HDR 10-bit, pembuatan video lebih panjang, dan kontrol referensi yang kuat. Hasilnya mencapai resolusi 4K native dengan kedalaman warna HDR 10-bit, sehingga cocok untuk periklanan dan pravisualisasi film.^[2][5]

Bagi pengguna API, fitur yang paling menonjol adalah sistem referensi multimodal. Anda dapat memberikan hingga 50 input referensi multimodal dalam satu proses pembuatan, termasuk gambar, klip video, file audio, model 3D, dan sketsa CAD. Hal ini sangat berpengaruh saat Anda perlu menjaga karakter, produk, atau gaya visual tetap konsisten di beberapa shot. Seedance 2.5 juga mendukung masking bagian frame, seperti logo atau latar, lalu menggantinya tanpa merender ulang seluruh klip.^[5][13]

Model ini juga menghasilkan audio bersama video, termasuk dialog, sinkronisasi bibir, dan suara sekitar. Dengan demikian, tim dapat menguji ide dan merevisi klip tanpa langsung menambahkan langkah pascaproduksi terpisah.^[13][8]

Kepatuhan prompt dilaporkan meningkat sekitar 20% dibandingkan Seedance 2.0.^[13]

Fitur-fitur tersebut menentukan keputusan berikutnya: jalur akses mana yang digunakan dan berapa anggaran yang perlu disiapkan.

Posisi Seedance 2.5 dalam ekosistem Doubao

Seedance 2.5 juga tersedia di Jimeng AI dan Doubao Pro untuk penggunaan tanpa API.

Bagi pengembang, akses API berjalan melalui BytePlus ModelArk di luar Tiongkok daratan dan Volcano Engine Ark di Tiongkok daratan. Saat ini akses terbatas pada beta perusahaan.^{[2][3][10][11]} Dalam pengaturan tersebut, Seedance 2.5 berfungsi sebagai model yang dapat dipanggil di dalam platform cloud, dengan autentikasi, pengelolaan kuota, pemantauan tugas, dan logging ditangani pada tingkat platform.^[12][4]

Jalur API, termasuk opsi akses terpadu seperti APIMart, juga menjadi tempat Anda mendapatkan kontrol lebih rinci, seperti edit wilayah dan kapasitas referensi tinggi.^[11][12][4] Bagian berikut menguraikan cara meminta akses dan persyaratan setiap jalur.

Berikutnya, bandingkan jalur akses, persyaratan onboarding, dan penagihan.

2. Cara mendapatkan akses API

Akses resmi melalui BytePlus ModelArk dan Volcano Engine Ark

ByteDance menawarkan dua jalur API pihak pertama. Pilihan Anda terutama bergantung pada lokasi operasi tim.

BytePlus ModelArk adalah pilihan internasional bagi tim di luar Tiongkok daratan. Penagihannya menggunakan USD dan tersedia dokumentasi berbahasa Inggris.^[22][23][24] Penyiapannya cukup langsung: buat akun BytePlus, aktifkan ModelArk di konsol, aktifkan model Seedance, dan buat kunci API. Kemudian gunakan endpoint regional yang ditampilkan di konsol beserta ID model Seedance 2.5 yang terkait dengan akun Anda.

Volcano Engine Ark mengikuti jalur yang hampir sama, tetapi ditujukan untuk operasi Tiongkok daratan. Anda membuat akun bisnis, mengaktifkan Ark, membuat kunci API, dan memanggil endpoint regional dengan autentikasi Bearer. Penagihannya memakai CNY dan memerlukan verifikasi bisnis, termasuk KYC.^[6][20][21]

Ada satu hal penting: akses Seedance 2.5 masih diluncurkan secara bertahap. Jadi, meskipun ID model publik telah tercantum, versi 2.5 mungkin belum muncul. Sebelum memasangnya ke produksi, periksa konsol untuk ID model saat ini.^[2][3]

Setelah memilih jalur, langkah berikutnya adalah mengatur penagihan dan format permintaan.

Akses terpadu melalui APIMart

Jika Anda lebih suka memakai satu pola klien untuk berbagai model, jalur API terpadu dapat mempermudah pekerjaan.

APIMart menawarkan satu API yang kompatibel dengan OpenAI untuk model video, gambar, dan bahasa, semuanya dengan satu kunci dan satu URL dasar.^[1][16][17] Untuk memulai, buat akun APIMart, hasilkan kunci API bergaya OpenAI, arahkan klien HTTP atau SDK yang kompatibel dengan OpenAI ke https://api.apimart.ai/v1, lalu kirim permintaan ke endpoint terpadu videos/generations dengan ID model yang diinginkan.^{[17][18][14][15]}

Karena antarmukanya mengikuti schema OpenAI, tim yang sudah menggunakan pengaturan tersebut untuk model bahasa dapat menambahkan pembuatan video tanpa mengubah alur autentikasi atau membangun ulang logika permintaan. Sederhananya: pola sama, model baru. Jaga agar ID model mudah diubah selama Seedance 2.5 diluncurkan.

Perbandingan jalur akses, onboarding, penagihan, dan gaya API

Gunakan tabel berikut untuk membandingkan wilayah, penagihan, dan gaya klien.

3. Cara kerja harga dalam praktik

Harga per detik, penagihan berbasis token, dan faktor biaya

Setelah memilih jalur akses, harga menjadi pekerjaan penyusunan anggaran yang sederhana. Harga Seedance 2.5 berbeda menurut jalur: BytePlus ModelArk menagih per detik dalam USD, sedangkan Volcano Engine Ark menagih per sejuta token dalam CNY. Tarif juga berubah tergantung apakah permintaan menyertakan input video.^[9][7]

Empat faktor membentuk sebagian besar tagihan. Durasi hasil adalah faktor terbesar. Klip 30 detik berharga sekitar enam kali lebih mahal daripada klip 5 detik dengan tarif yang sama. Berikutnya adalah resolusi. Harga Seedance 2.0 dari ModelArk mencantumkan 720p Standard seharga $0.199/detik dan 480p Standard seharga $0.092/detik.^[9] Audio juga dapat menambah biaya, begitu pula permintaan yang memakai video referensi.

Seedance 2.5 masih belum memiliki tarif publik resmi. Jadi, anggap angka saat ini sebagai perkiraan perencanaan dan periksa harga langsung di konsol sebelum berkomitmen.^[25][10]

Contoh anggaran untuk tim AS

Cara termudah memperkirakan biaya render adalah:

biaya render = detik × tarif per detik

Untuk perkiraan bulanan, gunakan rumus ini:

render per hari × detik rata-rata per render × tarif per detik × hari per bulan

Berikut contoh praktiknya. Tim pemasaran yang membuat 20 klip pendek per hari, masing-masing rata-rata 8 detik, dengan tarif $0.20/detik, akan menghabiskan sekitar $960/bulan. Tim produk yang membuat 5 demo lebih panjang per hari, masing-masing 30 detik, akan menghabiskan sekitar $900/bulan dengan tarif yang sama. Total tersebut meningkat jika Anda beralih ke hasil beresolusi lebih tinggi, menambahkan audio, atau memakai alur video referensi. Sisihkan juga anggaran untuk percobaan ulang dan versi tambahan.

Setelah memetakan pengeluaran, langkah selanjutnya adalah memilih alur permintaan dan format input.

Cara harga APIMart mendukung pemeriksaan biaya Seedance

Gunakan harga Seedance yang diterbitkan APIMart untuk memperkirakan biaya per klip, lalu verifikasi perkiraan tersebut dengan batch pengujian kecil sebelum produksi.

4. Cara mengintegrasikan Doubao Seedance 2.5 ke aplikasi

Alur permintaan dasar dengan klien REST dan proses yang kompatibel dengan SDK

Setelah akses dan harga dipetakan, integrasi pada dasarnya berupa loop tugas asinkron sederhana ditambah penyiapan input yang cermat.

Dalam praktiknya, alurnya cukup mudah diprediksi: kirim tugas, lakukan polling status, dan simpan hasil setelah selesai. Gunakan pola asinkron yang sama untuk setiap permintaan: autentikasi dengan Bearer token, POST permintaan pembuatan, lakukan polling ID tugas setiap 8–15 detik,^[19] lalu unduh video begitu status berubah menjadi succeeded.

Simpan kunci API dalam variabel lingkungan sisi server. Jangan pernah menaruhnya dalam kode sisi klien.

Jika memakai APIMart, Anda dapat mempertahankan kode SDK yang kompatibel dengan OpenAI dan hanya mengubah URL dasar serta nama model. Ini merupakan jalan pintas yang praktis bila alur Anda sudah tersedia.

Mulailah dengan menguji permintaan menggunakan cURL. Kemudian pindahkan logika tersebut ke modul layanan dengan percobaan ulang dan penanganan kesalahan bersama.

Untuk kesalahan, gunakan exponential backoff pada respons 429, yang berarti Anda mencapai batas kecepatan. Namun, jangan mencoba ulang kesalahan 400, 401, atau 402 secara otomatis. Kode tersebut biasanya menunjukkan permintaan buruk, masalah autentikasi, atau penagihan, sehingga perlu pemeriksaan manual sebelum tugas dikirim lagi.

Desain input untuk pembuatan video teks, gambar, dan berbasis referensi

Setelah loop permintaan siap, langkah berikutnya adalah bagian yang menentukan kualitas hasil: prompt dan aset sumber.

Mulailah dengan empat input:

• Struktur prompt
• Aset
• Durasi
• Resolusi

Untuk prompt, format yang konsisten adalah Subjek → Tindakan → Kamera → Latar → Suasana. Format ini memberi tim cara berulang untuk menulis prompt tanpa memulai dari awal setiap kali. Jika menjalankan kampanye untuk banyak produk, pustaka prompt berdasarkan kampanye atau jenis produk dapat menghemat waktu dan mengurangi percobaan ulang.

Untuk resolusi, sebaiknya buat draf pada 480p atau 720p terlebih dahulu. Kemudian jalankan ulang tugas pada 1080p atau 4K untuk ekspor akhir. Pengujian awal menjadi lebih ringan dan Anda dapat menemukan masalah sebelum membelanjakan lebih banyak biaya pada render akhir.

Format dan durasi harus sesuai dengan kanal. Untuk media sosial, video vertikal 9:16 dalam rentang 5–15 detik sesuai dengan batas platform yang umum. Untuk etalase e-commerce, 10–30 detik pada 16:9 atau 1:1 cenderung lebih cocok.

Seedance 2.5 mendukung hingga 50 file referensi multimodal dalam satu permintaan.^[26] Untuk pipeline produksi, simpan aset referensi tersebut dalam penyimpanan objek berversi dan panggil melalui URL stabil pada setiap permintaan. Tambahkan metadata seperti ID produk, kampanye, dan wilayah ke setiap aset agar Anda dapat melacak input yang menghasilkan setiap keluaran. Saat tim bertanya, “Kumpulan gambar mana yang menghasilkan versi ini?”, Anda akan memiliki jawaban yang jelas.

Kasus penggunaan untuk tim produk dan bisnis

Pilihan pengaturan ini berubah sesuai dengan tugas yang ingin dilakukan.

Tim e-commerce dapat mengubah gambar katalog menjadi video produk dalam skala besar, lalu mengirim video tersebut ke tahap peninjauan sebelum diterbitkan.

Tim pemasaran dapat membuat variasi regional dari satu konsep dasar dengan mengganti bahasa prompt dan gambar referensi. Gagasan sama, pasar berbeda.

Tim pendidikan dan praproduksi dapat mengantrekan tugas dalam batch sepanjang malam dan menyimpan hasil untuk ditinjau kemudian. Dalam praproduksi, fitur blockout model putih 3D Seedance 2.5 membantu sutradara dan pengarah seni memetakan komposisi adegan sebelum menggunakan aset produksi penuh.

Satu aturan harus tetap berlaku untuk semua kasus tersebut: letakkan panggilan API Seedance di belakang backend. Biarkan server mengirim tugas, melakukan polling status, dan menyimpan hasil. Frontend hanya perlu membaca data status internal dan URL akhir.

Kesimpulan, memilih jalur akses dan integrasi yang tepat

Seedance 2.5 adalah API video multimodal untuk alur terprogram. API ini cocok bagi tim produk dan kreatif yang membutuhkan pembuatan video dari teks, gambar, dan referensi dalam skala besar.

Setelah kasus penggunaan jelas, pilih jalur akses yang sesuai dengan wilayah, kebutuhan kepatuhan, dan pengaturan penagihan. Sederhananya, gunakan jalur yang sejalan dengan cara tim beroperasi dan tempat Anda melakukan deployment.

Setelah itu, perencanaan biaya terutama bergantung pada satu faktor: durasi klip. Cara sederhana memperkirakan anggaran adalah:

durasi klip × volume bulanan × tarif per detik

Melacak penggunaan uji coba, produksi, dan pengembangan secara terpisah juga membantu. Biaya menjadi lebih mudah dibaca dan aktivitas pengujian tidak mengaburkan angka produksi.

Setelah memahami biaya, pertahankan build pertama dalam skala kecil. Mulai dengan satu endpoint, satu prompt, dan satu klip, lalu tambahkan logging dan pemantauan saat penggunaan meningkat.

Tanya jawab

Bagaimana cara memastikan Seedance 2.5 aktif di akun saya?

Periksa dasbor APIMart atau halaman Pengelolaan Kunci untuk memastikan apakah Seedance 2.5 diaktifkan dalam cakupan kunci API saat ini.

Karena ini model yang lebih baru, akses dapat berbeda menurut wilayah atau tingkat akun. Jika permintaan mengembalikan kesalahan 403 Forbidden, kunci API Anda belum memiliki izin untuk menggunakan Seedance 2.5.

Berapa anggaran yang perlu disiapkan untuk batch pengujian pertama?

Gunakan harga Seedance 2.0 sebagai patokan. Seedance 2.5 kemungkinan akan mengikuti model penagihan per detik yang serupa, sehingga perkiraan wajar adalah sekitar $0.10 hingga $0.20 per detik untuk hasil 480p atau 720p.

Untuk mengendalikan pengeluaran, mulai dengan draf beresolusi lebih rendah. Simpan render 1080p atau 4K untuk versi akhir. Alur sederhana ini membantu menghindari pemborosan dana pada pengujian.

Perhatikan juga biaya klip referensi. Biaya tersebut dapat meningkatkan total, sering kali sebesar 50% dari tarif hasil per detik.

Penyiapan backend apa yang diperlukan sebelum integrasi?

Gunakan backend sisi server yang aman untuk setiap permintaan. Jangan pernah mengekspos kunci API dalam kode sisi klien, kontrol sumber, atau image container. Simpan di pengelola rahasia atau variabel lingkungan, lalu masukkan saat runtime.

Backend juga harus mencakup audit logging dan alur asinkron idempoten. Artinya, backend harus mengirim permintaan, menyimpan ID tugas, melakukan polling hingga selesai, dan memindahkan video ke penyimpanan permanen atau CDN Anda sebelum URL hasil kedaluwarsa.