Materi Seedance TokenLab: Referensi Video yang Dapat Digunakan Kembali untuk Alur Kerja Produksi

Jika tim Anda pernah menempelkan URL face-swap yang sama ke dalam tiga panggilan API yang berbeda, Anda sudah tahu mengapa pustaka materi Seedance ada. Referensi video yang dapat digunakan kembali bekerja lebih baik sebagai aset dengan status siklus hidup daripada sebagai URL sekali pakai yang disalin dari lembar kerja ke setiap permintaan pembuatan. TokenLab mencakup aset tersebut ke organisasi Anda, sehingga Anda dapat menyimpan, memverifikasi, dan menggunakan kembali referensi di berbagai panggilan. Kami menguji bentuk alur kerja tersebut: grup mengatur materi orang asli, aset menampung referensi aktual, dan panggilan pembuatan hanya menggunakan ID setelah status mencapai ACTIVE. Sebagai contoh, tim yang dulunya menyimpan lembar kerja berisi tautan gambar dan mengunggah ulang video referensi yang sama sebanyak lima kali dapat mengganti kebiasaan tersebut dengan satu ID aset materi.

Poin Penting

• Aset materi adalah objek referensi yang siap untuk pembuatan; grup materi adalah wadah yang mengatur aset terkait, terutama untuk alur kerja orang asli.
• Gunakan id aset materi sebagai material_asset_id (atau di dalam material_asset_ids) hanya setelah statusnya mencapai ACTIVE.
• Terdapat dua jenis pustaka: aigc_avatar untuk avatar virtual dan referensi lain yang dapat digunakan kembali yang bukan orang asli, serta liveness_face untuk grup materi orang asli yang memerlukan verifikasi.
• TokenLab dapat secara otomatis menyiapkan input gambar yang kompatibel (image, image_url, image_urls, reference_images, start_image, end_image) menjadi aset materi tanpa langkah pengunggahan terpisah.
• Jika persiapan berjalan lebih dari 60 detik, API akan mengembalikan 409 seedance_material_preparing bersama dengan auto_material_asset_ids yang dapat Anda poll dan coba lagi.
• Seedance adalah keluarga model publik saat ini yang didukung oleh sistem materi ini. Verifikasi detail kemampuan per model yang tepat di dokumentasi sebelum membangun dependensi pada tingkatan tertentu.

Pustaka Materi Seedance: Aset dan Grup

Materi Seedance adalah referensi yang dapat digunakan kembali — gambar, video, atau audio — yang disimpan oleh TokenLab sebagai aset lingkup organisasi, bukan URL lingkup permintaan. Alih-alih meneruskan tautan file mentah ke setiap panggilan create-video, Anda mengunggah atau mengimpor referensi tersebut sekali, menunggu hingga siap untuk pembuatan, lalu mereferensikannya berdasarkan ID dalam panggilan sebanyak yang Anda perlukan.

Hal ini penting karena tiga alasan praktis. Pertama, pengunggahan berulang membuang bandwidth dan menambah latensi pada setiap permintaan, terutama untuk video referensi berukuran besar. Kedua, URL mentah dapat kedaluwarsa, dirotasi, atau dicabut oleh sistem penyimpanan apa pun yang menampungnya. Aset materi yang dikelola TokenLab tidak memiliki kerapuhan tersebut. Ketiga, dan yang paling relevan bagi tim yang membangun alur kerja video yang konsisten dengan karakter atau merek, materi memberikan pengenal stabil yang dapat Anda buat versinya, audit, dan tukar tanpa harus mengubah logika pembuatan Anda setiap saat.

Aset Materi vs. Grup Materi

Dua objek inti dalam sistem ini adalah aset materi dan grup aset materi. Mudah untuk mencampuradukkannya jika Anda belum membaca referensi API dengan saksama.

Aset materi adalah satu objek referensi — satu gambar avatar, satu wajah yang terverifikasi keasliannya (liveness-verified), satu klip video referensi. Saat Anda membuatnya, API akan mengembalikan id. id itulah yang nantinya Anda teruskan ke panggilan pembuatan video setelah aset mencapai status ACTIVE.

Grup aset materi adalah wadah yang diidentifikasi oleh group_id. Grup mengatur aset terkait menjadi satu. Secara struktural, grup diperlukan untuk alur kerja orang asli (liveness_face), di mana verifikasi dilakukan di tingkat grup sebelum aset individu dapat diunggah ke dalamnya.

Singkatnya: group_id untuk mengatur; material_asset_id untuk membuat. Anda akan melihat kedua kolom tersebut di bagian API yang berbeda. Menggunakan kolom yang salah di tempat yang salah adalah kesalahan integrasi paling umum yang dilakukan tim dengan sistem ini.

Kolom	Apa yang diidentifikasi	Di mana Anda menggunakannya
group_id	Grup aset materi (wadah)	Membuat atau mereferensikan grup, terutama untuk alur verifikasi orang asli
id (pada aset materi)	Satu referensi yang dapat digunakan kembali	Menjadi material_asset_id setelah ACTIVE
material_asset_id	Satu referensi aset, tunggal	Diteruskan ke create-video untuk satu slot referensi
material_asset_ids	Array referensi aset	Diteruskan ke create-video saat diperlukan beberapa referensi

Definisi kolom lengkap dan parameter yang diperlukan didokumentasikan di referensi API create material asset dan create material asset group. Baca bagian tersebut sebelum menghubungkannya ke kode produksi. Dokumentasi tersebut mencakup bentuk alur kerja, bukan setiap parameter permintaan.

Alur Kerja Avatar Virtual dan Orang Asli

Materi Seedance mendukung dua jenis pustaka. Perbedaannya bukan sekadar kosmetik — ini mencerminkan dua postur keamanan dan persetujuan yang berbeda.

aigc_avatar: Avatar Virtual dan Referensi Bukan Orang Asli

Jenis aigc_avatar mencakup referensi yang dapat digunakan kembali yang tidak terikat pada orang asli yang terverifikasi: karakter ilustrasi, avatar sintetis, figur bergaya, maskot produk, dan aset serupa. Anda dapat membuatnya langsung melalui alur pembuatan aset materi tanpa langkah verifikasi.

Jika produk Anda menghasilkan video seputar karakter fiksi atau avatar merek, ini hampir pasti adalah jenis pustaka yang Anda inginkan. Jalur pembuatannya lebih sederhana karena tidak ada persyaratan verifikasi identitas yang melekat padanya.

liveness_face: Grup Materi Orang Asli

Jenis liveness_face ditujukan untuk grup materi yang dibangun di sekitar rupa orang asli. Ini adalah jenis referensi yang digunakan untuk pembuatan video yang konsisten dengan wajah yang menampilkan individu nyata. Karena ini menyentuh identitas dan persetujuan, TokenLab memerlukan alur verifikasi sebelum aset dapat diunggah ke dalam grup.

Urutan verifikasi memiliki beberapa langkah yang berbeda:

1. Pembuatan sesi — backend Anda meminta sesi verifikasi untuk grup tersebut.
2. Alur H5 — orang yang diverifikasi menyelesaikan pemeriksaan keaslian (liveness check) melalui alur web yang di-host. H5 merujuk pada antarmuka verifikasi web seluler.
3. Callback — TokenLab memberi tahu sistem Anda saat sesi verifikasi selesai.
4. Bind result — identitas yang terverifikasi diikat ke grup materi.
5. Pengunggahan lingkup grup — hanya setelah pengikatan berhasil, aset materi dapat diunggah ke grup spesifik tersebut.

Ini berarti materi orang asli pada dasarnya bersifat group-first. Anda tidak dapat langsung membuat aset seperti yang Anda lakukan dengan aigc_avatar. Grup harus ada dan lulus verifikasi sebelum pengunggahan aset apa pun ke dalamnya dianggap valid.

Daftar Periksa: Memilih Jenis Pustaka yang Tepat

• Apakah referensi tersebut adalah wajah atau rupa orang asli yang dapat diidentifikasi? → Gunakan liveness_face dan rencanakan alur verifikasi.
• Apakah referensi tersebut sintetis, ilustrasi, atau avatar bukan orang asli? → Gunakan aigc_avatar dan lewati verifikasi.
• Apakah produk Anda memerlukan identitas yang konsisten di berbagai pembuatan untuk orang asli yang sama? → Bangun grup sekali, verifikasi sekali, gunakan kembali grup untuk aset di masa mendatang.
• Apakah Anda tidak yakin jenis apa referensi yang diberikan pelanggan? → Perlakukan sebagai liveness_face sampai dikonfirmasi sebaliknya; verifikasi di dokumentasi, jangan berasumsi.

Jangan berasumsi setiap model pembuatan atau setiap jenis permintaan mendukung kedua jenis pustaka secara identik. Konfirmasikan dukungan saat ini di panduan Model Video Seedance sebelum berkomitmen pada suatu arsitektur.

Cara Kerja Persiapan Materi Otomatis

Tidak semua referensi memerlukan langkah pengunggahan manual. TokenLab dapat secara otomatis menyiapkan input gambar yang kompatibel menjadi aset materi sebagai bagian dari permintaan pembuatan. Hal ini menghilangkan satu langkah perjalanan data untuk kasus sederhana.

Kolom yang dikenali untuk persiapan otomatis adalah:

• image
• image_url
• image_urls
• reference_images
• start_image
• end_image

Jika Anda meneruskan salah satu dari ini langsung ke panggilan pembuatan, TokenLab akan menangani impor dan persiapan di balik layar. Anda tidak perlu memanggil titik akhir aset materi secara terpisah terlebih dahulu.

Apa yang Terjadi Jika Persiapan Memakan Waktu Lebih dari 60 Detik

Persiapan biasanya cepat. Gambar referensi yang lebih besar atau lebih kompleks mungkin memerlukan waktu lebih lama untuk diproses menjadi aset yang siap untuk pembuatan. Jika persiapan melebihi 60 detik, API akan merespons dengan:

409 seedance_material_preparing

bersama dengan kolom auto_material_asset_ids yang berisi ID aset yang masih disiapkan.

Ini bukan kesalahan dalam pengertian konvensional. Ini adalah sinyal untuk mencoba lagi. Integrasi Anda harus memperlakukan 409 seedance_material_preparing sebagai respons 'periksa kembali nanti', bukan kegagalan yang ditampilkan kepada pengguna akhir. Lakukan polling pada ID aset yang dikembalikan, tunggu hingga status ACTIVE, lalu lanjutkan pembuatan menggunakan ID tersebut.

Dalam alur kerja kami, kami memperlakukan status ini seperti rate-limit backoff: diharapkan, bersifat sementara, dan ditangani dalam kode alih-alih dilaporkan sebagai kesalahan yang dihadapi pengguna. Kami merekomendasikan perulangan coba lagi (retry loop) kecil, bukan hanya satu kali coba/tangkap (try/catch).

Menggunakan Pustaka Materi Seedance dalam Pembuatan

Setelah aset materi — baik yang diunggah secara manual maupun disiapkan secara otomatis — mencapai status ACTIVE, id-nya dapat digunakan sebagai material_asset_id atau sebagai entri dalam material_asset_ids dalam panggilan create video.

Alur kerja intinya terlihat seperti ini:

1. Tentukan apakah referensi tersebut adalah orang asli atau bukan. Pilih liveness_face (dengan verifikasi) atau aigc_avatar yang sesuai.
2. Jika orang asli: buat grup materi, jalankan sesi verifikasi dan alur H5, terima callback, dan ikat hasilnya.
3. Buat atau impor aset materi — baik melalui panggilan unggah langsung, atau dengan membiarkan persiapan otomatis menangani kolom gambar yang kompatibel di dalam permintaan pembuatan.
4. Periksa status. Jangan teruskan ID aset ke pembuatan sampai statusnya ACTIVE.
5. Jika Anda mendapatkan 409 seedance_material_preparing, lakukan polling pada auto_material_asset_ids yang dikembalikan dan coba lagi setelah statusnya menjadi ACTIVE.
6. Gunakan id sebagai material_asset_id atau di dalam material_asset_ids dalam panggilan create-video Anda, dengan menargetkan model Seedance saat ini tergantung pada kebutuhan latensi dan kualitas Anda.
7. Gunakan kembali ID aset yang sama di berbagai panggilan pembuatan di masa mendatang alih-alih mengunggah ulang referensi.

Di sinilah manajemen tugas menjadi penting. Panggilan pembuatan yang dibangun di atas aset materi yang digunakan kembali mungkin perlu dihentikan di tengah jalan. Hal itu bisa terjadi karena pengendalian biaya, perubahan brief kreatif, atau perintah (prompt) yang buruk. Lihat artikel pendamping kami tentang pembatalan tugas Seedance untuk mengetahui bagaimana pembatalan berinteraksi dengan pekerjaan video yang sedang berlangsung.

Untuk perbandingan yang lebih luas mengenai apa yang tersedia saat ini di berbagai model pembuatan video di TokenLab, halaman kategori model video mencantumkan opsi saat ini secara berdampingan.

Langkah Praktis Selanjutnya

• Jika Anda sedang membuat prototipe, mulailah dengan materi aigc_avatar. Jalur pembuatannya lebih sederhana dan tidak ada dependensi verifikasi yang harus dibangun terlebih dahulu.
• Jika produk Anda memerlukan konsistensi orang asli, bangun alur verifikasi (sesi → H5 → callback → bind) sebagai bagian utama dari proses orientasi Anda, bukan sebagai tambahan.
• Tambahkan perulangan coba lagi untuk 409 seedance_material_preparing sebelum Anda merilis apa pun ke produksi. Perlakukan sebagai perilaku yang diharapkan, bukan kasus khusus.
• Simpan ID aset materi bersama catatan referensi internal Anda sendiri. Dengan begitu, Anda tidak perlu mencari ulang aset mana yang dipetakan ke karakter atau produk mana.
• Tinjau referensi API aset materi dan grup aset materi secara langsung. Dokumentasi menjelaskan bentuk alur kerja, dan kolom permintaan/respons yang tepat harus dikonfirmasi terhadap dokumentasi saat ini sebelum Anda menulis kode integrasi.

Dasbor aset Seedance menampilkan status, jenis pustaka, dan hubungan grup untuk aset yang telah Anda buat.

Tarif saat ini dalam ikhtisar harga API video AI 2026 kami membantu Anda memahami bagaimana biaya berskala dengan penggunaan. Anda juga dapat melacak dan mengekspor data penggunaan Anda sendiri menggunakan panduan di ekspor penggunaan dasbor TokenLab.

FAQ

Apa perbedaan aset materi dan grup materi?

Aset materi adalah satu objek referensi yang dapat digunakan kembali — satu gambar avatar, satu wajah yang terverifikasi keasliannya, satu klip video referensi. id-nya menjadi material_asset_id setelah ACTIVE. Grup materi adalah wadah yang diidentifikasi oleh group_id. Grup mengatur aset terkait dan diperlukan untuk alur kerja liveness_face. Singkatnya: group_id untuk mengatur; material_asset_id untuk membuat.

Mengapa panggilan pembuatan mengembalikan 409 seedance_material_preparing?

Persiapan materi otomatis, yang dipicu oleh kolom gambar yang kompatibel seperti image_url atau start_image, dapat memakan waktu lebih dari 60 detik. Ketika itu terjadi, API mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Lakukan polling pada ID tersebut, tunggu hingga ACTIVE, dan coba lagi pembuatan. Ini menandakan status sementara yang sedang berlangsung, bukan kegagalan.

Apakah referensi orang asli selalu memerlukan verifikasi?

Ya. Gunakan jenis liveness_face dan alur verifikasinya setiap kali referensi melibatkan wajah atau rupa orang asli yang dapat diidentifikasi. Alur tersebut memerlukan pembuatan sesi, pemeriksaan keaslian H5, callback, dan langkah pengikatan sebelum aset apa pun dapat diunggah ke grup tersebut. Referensi bukan orang asli, seperti avatar ilustrasi atau sintetis, menggunakan aigc_avatar dan tidak memerlukan jalur ini.

Bisakah saya menggunakan kembali satu aset materi di berbagai pekerjaan video Seedance?

Ya, setelah aset mencapai ACTIVE. Gunakan id-nya sebagai material_asset_id atau di dalam material_asset_ids dalam panggilan create-video. Gunakan kembali ID aset yang sama di berbagai panggilan pembuatan di masa mendatang alih-alih mengunggah ulang referensi. Jika Anda perlu menghentikan pekerjaan yang sedang berlangsung, lihat pembatalan tugas Seedance.

Sumber dan Pembaruan

• Panduan Model Video Seedance — https://docs.tokenlab.sh/guides/seedance-2-video — diamati 2026-07-09
• Buat aset materi Seedance (referensi API) — https://docs.tokenlab.sh/api-reference/video/create-material-asset — diamati 2026-07-09
• Buat grup aset materi Seedance (referensi API) — https://docs.tokenlab.sh/api-reference/video/create-material-asset-group — diamati 2026-07-09
• Buat video (referensi API) — https://docs.tokenlab.sh/api-reference/video/create-video — diamati 2026-07-09
• Dasbor aset Seedance TokenLab — /dashboard/seedance-assets — diamati 2026-07-09

Perilaku API, nama kolom, dan semantik status yang dijelaskan di sini mencerminkan dokumentasi publik dan salinan dasbor per tanggal pengamatan. Sistem materi Seedance TokenLab sedang dalam pengembangan aktif — konfirmasikan nama parameter saat ini, nilai status, dan dukungan spesifik model dalam dokumentasi tertaut sebelum menyelesaikan kode integrasi produksi.

Jika Anda membangun alur kerja video yang bergantung pada referensi yang stabil dan dapat digunakan kembali, mulailah dengan panduan Model Video Seedance. Ini adalah cara tercepat untuk melihat nama parameter saat ini dan mengonfirmasi apa yang sebenarnya didukung oleh tingkatan model target Anda.