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

Referensi video yang dapat digunakan kembali lebih mudah dikelola jika berupa aset dengan status siklus hidup, bukan URL sekali pakai yang disalin ke dalam setiap permintaan pembuatan. Jika Anda pernah mengelola spreadsheet berisi tautan gambar, mengunggah ulang video referensi yang sama sebanyak lima kali, atau mengetik ulang URL face-swap ke dalam tiga panggilan API yang berbeda, Anda sudah memahami masalah yang dirancang untuk dipecahkan oleh materi Seedance.

Pustaka materi Seedance dari TokenLab memberikan cara bagi tim video untuk menyimpan, memverifikasi, dan menggunakan kembali referensi di seluruh panggilan pembuatan dengan cakupan organisasi. Artikel ini menjelaskan apa itu aset materi, bagaimana grup materi berhubungan dengan aset individu, cara kerja persiapan otomatis, dan di mana verifikasi orang asli (real-person) masuk ke dalam alur kerja.

Poin Utama

• Aset materi adalah objek referensi yang siap digunakan untuk pembuatan; grup materi adalah wadah yang mengatur aset terkait, terutama untuk alur kerja orang asli.
• Hanya gunakan id aset materi sebagai material_asset_id (atau di dalam material_asset_ids) 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 berlangsung lebih dari 60 detik, API akan mengembalikan 409 seedance_material_preparing beserta auto_material_asset_ids yang dapat Anda polling dan coba lagi.
• Seedance 2.0, Seedance 2.0 Fast, dan Seedance 2.0 Mini adalah model publik saat ini yang didukung oleh sistem materi ini. Pastikan detail kemampuan per model di dokumentasi sebelum membangun dependensi pada tingkatan tertentu.

Apa Itu Materi Seedance

Materi Seedance adalah referensi yang dapat digunakan kembali — gambar, video, atau audio — yang disimpan oleh TokenLab sebagai aset dengan cakupan organisasi, bukan URL dengan cakupan permintaan. Alih-alih meneruskan tautan file mentah ke dalam setiap panggilan create-video, Anda mengunggah atau mengimpor referensi tersebut satu kali, menunggu hingga siap digunakan, lalu mereferensikannya berdasarkan ID dalam sebanyak mungkin panggilan berikutnya 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 yang besar.

Kedua, URL mentah dapat kedaluwarsa, dirotasi, atau dicabut oleh sistem penyimpanan apa pun yang awalnya menampungnya. Aset materi yang dikelola oleh TokenLab tidak memiliki kerentanan tersebut.

Ketiga, dan yang paling relevan bagi tim yang membangun pipeline video yang konsisten dengan karakter atau merek, materi memberikan pengenal stabil yang dapat Anda buat versinya, audit, dan tukar tanpa harus mengubah logika pembuatan setiap saat.

Aset Materi vs. Grup Materi

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

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

Grup aset materi adalah wadah yang diidentifikasi oleh group_id. Grup mengatur aset terkait, dan secara struktural diperlukan untuk alur kerja orang asli (liveness_face), di mana verifikasi terjadi 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, dan 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)	Referensi tunggal yang dapat digunakan kembali	Menjadi material_asset_id setelah ACTIVE
material_asset_id	Referensi aset tunggal, singular	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 dokumentasi tersebut sebelum memasukkannya ke dalam kode produksi — artikel ini membahas bentuk alur kerja, bukan setiap parameter permintaan.

Alur Kerja Avatar Virtual dan Orang Asli

Materi Seedance mendukung dua jenis pustaka, dan 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. Ini dapat dibuat langsung melalui alur pembuatan aset materi tanpa langkah verifikasi.

Jika produk Anda menghasilkan video seputar karakter fiksi atau avatar merek, ini hampir pasti merupakan 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 kemiripan orang asli — 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 liveness melalui alur web yang dihosting (inilah yang dimaksud dengan "H5": antarmuka verifikasi web seluler).
3. Callback — TokenLab memberi tahu sistem Anda saat sesi verifikasi selesai.
4. Hasil pengikatan (Bind) — identitas yang terverifikasi diikat ke grup materi.
5. Pengunggahan cakupan grup — hanya setelah pengikatan berhasil, aset materi dapat diunggah ke grup tertentu tersebut.

Ini berarti materi orang asli secara inheren bersifat mengutamakan grup: 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 kemiripan 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? → Buat grup satu kali, verifikasi satu kali, 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 bahwa setiap model pembuatan atau setiap jenis permintaan mendukung kedua jenis pustaka secara identik — konfirmasikan dukungan saat ini di panduan Model Video Seedance 2.0 sebelum berkomitmen pada arsitektur tertentu.

Cara Kerja Persiapan Materi Otomatis

Tidak setiap referensi memerlukan langkah pengunggahan manual. TokenLab dapat secara otomatis menyiapkan input gambar yang kompatibel menjadi aset materi sebagai bagian dari permintaan pembuatan, yang menghilangkan satu perjalanan bolak-balik 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 dalam panggilan pembuatan, TokenLab menangani impor dan persiapan di balik layar alih-alih mengharuskan Anda memanggil endpoint aset materi secara terpisah terlebih dahulu.

Apa yang Terjadi Saat Persiapan Memakan Waktu Lebih dari 60 Detik

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

409 seedance_material_preparing

beserta 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 sebentar lagi", bukan kegagalan yang harus dilaporkan ke pengguna akhir. Polling ID aset yang dikembalikan, tunggu status ACTIVE, lalu lanjutkan dengan pembuatan menggunakan ID tersebut.

Secara praktis, ini berarti pipeline pembuatan Anda memerlukan loop coba lagi (retry loop) kecil, bukan hanya satu try/catch. Tim yang membangun pipeline video otomatis harus memperlakukan status ini dengan cara yang sama seperti mereka memperlakukan backoff batas kecepatan (rate-limit) — diharapkan, sementara, dan ditangani dalam kode alih-alih dilaporkan sebagai kesalahan yang dihadapi pengguna.

Cara Menggunakan Materi 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 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 dalam pembuatan sampai statusnya ACTIVE.
5. Jika Anda mendapatkan 409 seedance_material_preparing, polling 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 seperti seedance-2.0, seedance-2.0-fast, atau seedance-2.0-mini tergantung pada kebutuhan latensi dan kualitas Anda.
7. Gunakan kembali ID aset yang sama di seluruh panggilan pembuatan di masa mendatang alih-alih mengunggah ulang referensi.

Di sinilah manajemen tugas juga penting. Jika panggilan pembuatan yang dibangun di atas aset materi yang digunakan kembali perlu dihentikan di tengah jalan — untuk kontrol biaya, perubahan brief kreatif, atau prompt yang buruk — lihat artikel pendamping kami tentang pembatalan tugas Seedance untuk mengetahui bagaimana pembatalan berinteraksi dengan pekerjaan video yang sedang berjalan.

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

Langkah Praktis Selanjutnya

• Jika Anda 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 onboarding Anda, bukan sebagai tambahan.
• Tambahkan loop coba lagi untuk 409 seedance_material_preparing sebelum Anda mengirimkan apa pun ke produksi — perlakukan sebagai perilaku yang diharapkan, bukan kasus tepi (edge case).
• Simpan ID aset materi bersama catatan referensi internal Anda sendiri agar Anda tidak perlu mencari ulang aset mana yang memetakan ke karakter atau produk mana.
• Tinjau referensi API aset materi dan grup aset materi secara langsung — artikel ini menjelaskan bentuk alur kerja, dan kolom permintaan/respons yang tepat harus dikonfirmasi terhadap dokumentasi saat ini sebelum Anda menulis kode integrasi.

Anda dapat menelusuri pustaka materi secara langsung di dasbor aset Seedance untuk melihat status, jenis pustaka, dan hubungan grup untuk aset yang telah Anda buat.

Sebelum berkomitmen pada alur kerja produksi, ada baiknya meninjau tarif saat ini dalam ikhtisar harga API video AI 2026 kami untuk 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 itu aset materi Seedance? Aset materi adalah referensi pembuatan video yang dapat digunakan kembali — gambar, video, atau audio — yang disimpan sebagai objek dengan cakupan organisasi dengan status siklus hidupnya sendiri. Setelah mencapai ACTIVE, Anda dapat mereferensikannya berdasarkan ID di seluruh beberapa panggilan pembuatan alih-alih memasok ulang URL mentah setiap saat.

Apa perbedaan antara group_id dan material_asset_id? group_id mengidentifikasi grup aset materi, yang merupakan wadah yang digunakan terutama untuk mengatur aset orang asli (liveness_face) dan mengelola verifikasi di tingkat grup. material_asset_id mengidentifikasi referensi tunggal yang dapat digunakan kembali — id yang dikembalikan saat aset materi dibuat — dan itulah yang Anda teruskan ke panggilan pembuatan video.

Kapan saya harus menggunakan verifikasi orang asli? Gunakan jenis liveness_face dan alur verifikasinya kapan pun materi referensi melibatkan wajah atau kemiripan orang asli yang dapat diidentifikasi. Alur ini memerlukan pembuatan sesi, pemeriksaan liveness 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 verifikasi ini.

Apa arti seedance_material_preparing? Ini adalah respons 409 yang dikembalikan saat persiapan materi otomatis — yang dipicu oleh kolom gambar yang kompatibel seperti image_url atau start_image dalam permintaan pembuatan — memerlukan waktu lebih dari 60 detik untuk diselesaikan. Respons tersebut menyertakan auto_material_asset_ids sehingga Anda dapat melakukan polling pada ID tersebut dan mencoba lagi pembuatan setelah statusnya menjadi ACTIVE. Ini menandakan status sementara yang sedang berlangsung, bukan kegagalan.

Sumber dan Kesegaran

• Panduan Model Video Seedance 2.0 — 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 — https://tokenlab.sh/en/dashboard/seedance-assets — diamati 2026-07-09

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

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