Material Seedance dan verifikasi orang asli

Material Seedance adalah referensi gambar, video, atau audio yang dapat digunakan ulang dalam organisasi. Pilih alur terlebih dahulu: material avatar biasa dan material orang asli terverifikasi memiliki jalur pembuatan yang berbeda.

Pilih alur materialCopy Anchor Link

Konsep MateriCopy Anchor Link

Materi Seedance adalah referensi yang dapat digunakan kembali dan dicakup oleh organisasi yang dapat dipilih nanti selama pembuatan video.

Pisahkan group_id dan id aset materi. group_id digunakan untuk mengatur unggahan; id aset materi digunakan untuk pembuatan video. Jika permintaan video mengembalikan Seedance material asset not found or not accessible, pastikan Anda memberikan id aset materi, bukan group_id, dan bahwa aset tersebut milik organisasi yang sama, tidak dihapus, dan memiliki status: "ACTIVE".

Retensi MateriCopy Anchor Link

TokenLab menyimpan setiap aset materi sampai Anda menghapus aset atau grupnya. Aset tidak dibersihkan karena tidak aktif di sisi TokenLab.

Penyedia upstream Seedance dapat menghapus salinan kerjanya atas suatu aset setelah 30 hari tanpa penggunaan. Hal ini tidak menghapus aset Anda dan tidak mengubah ID-nya: saat Anda menggunakannya lagi dalam permintaan pembuatan, TokenLab otomatis menyiapkan salinan upstream baru dari file asli yang tersimpan.

• Pembuatan pertama setelah pembersihan bisa sedikit lebih lama selagi salinan baru disiapkan. Jika belum siap, permintaan mengembalikan seedance_material_preparing; coba lagi sebentar lagi.
• Menghapus aset atau grup bersifat permanen dan tidak dapat dibatalkan.

URL gambar dan material yang dapat digunakan kembaliCopy Anchor Link

Kirim URL HTTP(S) publik atau data URL yang didukung pada field gambar model pilihan. Input ini mengikuti pemrosesan media biasa dan tidak otomatis membuat ID material yang dapat digunakan kembali.

Untuk menggunakan kembali material, buat aset melalui API material, tunggu ACTIVE, lalu gunakan material_asset_id, material_asset_ids, atau asset://<id> pada field media yang didukung. Pertahankan perannya sebagai bingkai awal, bingkai akhir, atau gambar referensi.

Jika material yang disebutkan secara eksplisit masih dipersiapkan, POST /v1/videos/generations mengembalikan 409 seedance_material_preparing beserta inactive_asset_ids. Periksa aset hingga ACTIVE, lalu ulangi dengan ID yang sama. Jika FAILED, periksa error_message dan perbaiki atau impor ulang terlebih dahulu.

Verifikasi Materi Orang AsliCopy Anchor Link

Gunakan verifikasi materi orang asli ketika produk Anda memerlukan persetujuan dan verifikasi wajah sebelum orang asli dapat digunakan sebagai referensi Seedance yang dapat digunakan kembali.

1. Panggil Membuat sesi validasi visual dengan CallbackURL dan simpan Result.BytedToken yang dikembalikan.
2. Buka Result.H5Link untuk orang yang akan diverifikasi. Tambahkan lng ke tautan H5 jika Anda memerlukan bahasa tertentu.
3. Setelah alur H5 selesai, browser membuka Result.CallbackURL dengan nama kueri resmi seperti bytedToken dan resultCode.
4. Lakukan polling Mendapatkan hasil validasi visual dengan BytedToken hingga Result.GroupId dikembalikan.
5. Simpan GroupId dan gunakan sebagai group_id saat membuat material liveness_face.

BytedToken berlaku selama 30 menit. Gunakan ProjectName yang sama dalam kedua permintaan Action. Autentikasi menggunakan Authorization: Bearer <TOKENLAB_API_KEY>; tanda tangan AK/SK Volc tidak diterima.

Buka H5Link yang dikembalikan segera setelah dibuat. Masa berlaku token tidak menjamin halaman verifikasi dapat dibuka pertama kali kapan saja dalam rentang tersebut.

Opsional: gunakan konsol pengujian untuk memverifikasi permintaan dan alur callback Anda, memeriksa grup materi, dan meninjau riwayat verifikasi. Integrasi produksi Anda harus memanggil API secara langsung.

Membuat Grup MateriCopy Anchor Link

Gunakan Membuat Grup Aset Material untuk grup aigc_avatar. Grup orang asli yang baru dibuat melalui alur verifikasi agar orang yang terverifikasi dan grup materi tetap tertaut.

Gunakan Mencantumkan Grup Aset Material, Mendapatkan Grup Aset Material, Memperbarui Grup Aset Material, dan Hapus Grup Aset Material untuk mengelola grup setelah grup tersebut ada.

Menghapus grup materi juga akan menghapus materi TokenLab di dalamnya dan tidak dapat dibatalkan. Jika pustaka materi TokenLab tidak dapat menyelesaikan penghapusan karena status otorisasi saat ini tidak mengizinkannya, TokenLab akan mengembalikan kesalahan pustaka materi netral.

Mengunggah MateriCopy Anchor Link

Gunakan Membuat Aset Material untuk mengimpor satu URL sumber yang dapat diakses publik dalam satu waktu.

Untuk aigc_avatar, group_id bersifat opsional; TokenLab menggunakan atau membuat grup avatar virtual default organisasi. Untuk liveness_face, group_id wajib diisi dan harus berupa grup yang dikembalikan oleh Mendapatkan hasil validasi visual.

Tabel menunjukkan batas impor file. Permintaan diterima tidak menjamin media atau verifikasi orang asli lolos. Tunggu ACTIVE; jika FAILED, perbaiki sumber berdasarkan error_message sebelum mengimpor ulang.

Penyerapan materi bersifat asinkron. Lakukan polling pada Mendapatkan Material Asset hingga status menjadi ACTIVE. Respons HTTP yang berhasil hanya berarti permintaan telah diterima; selalu baca status bisnisnya. Jika statusnya FAILED, periksa error_message, perbaiki materi sumber, dan buat aset baru.

Dalam permintaan pembuatan material, asset_url hanya merupakan sumber impor. TokenLab mengembalikan id aset material; gunakan id tersebut untuk pembuatan video, bukan URL asli.

TokenLab menyimpan aset material di pustaka material organisasi Anda sampai Anda menghapus aset tersebut atau grup materialnya. Salinan upstream dibuat ulang secara otomatis jika dibersihkan; lihat bagian retensi di atas.

Untuk grup materi orang asli, satu grup memetakan ke satu orang asli. Unggahan diperiksa terhadap wajah yang terverifikasi. Aset dengan banyak wajah atau wajah yang tidak cocok dengan orang yang terverifikasi dapat gagal. Untuk hasil terbaik, unggah gambar referensi seluruh tubuh dari depan dan foto close-up menghadap ke depan di mana wajah terlihat jelas.

Menggunakan Materi dalam Pembuatan VideoCopy Anchor Link

Setelah aset berstatus ACTIVE, berikan id aset TokenLab yang dikembalikan sebagai material_asset_id, atau sertakan dalam material_asset_ids, saat memanggil Buat video. Aset materi dihitung terhadap batas referensi Seedance.

REST atau Action VolcengineCopy Anchor Link

Integrasi native TokenLab dapat tetap memakai API REST snake_case /v1/videos/assets*. Klien Volcengine yang ada dapat mempertahankan body PascalCase dengan Action material kompatibel Volcengine. Keduanya mengoperasikan data material yang sama dalam lingkup organisasi dan project.

Contoh APICopy Anchor Link

Buat grup avatar virtual, unggah gambar, lakukan polling hingga aktif, lalu gunakan ID aset materi dalam permintaan video.

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references"}'

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-abc12","asset_url":"https://example.com/reference.png","asset_type":"Image"}'

curl https://api.tokenlab.sh/v1/videos/assets/asset-20260720123457-def45 \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Untuk grup material orang asli, buat sesi validasi visual dan dapatkan hasilnya sebelum mengunggah material.

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

Alur Action lengkap untuk orang asliCopy Anchor Link

Berikan GroupId dari hasil verifikasi ke CreateAsset.

curl 'https://api.tokenlab.sh/?Action=CreateAsset&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "GroupId":"group-20260720123456-real1",
    "URL":"https://example.com/person-front.png",
    "Name":"Verified front view",
    "AssetType":"Image",
    "ProjectName":"default"
  }'

Polling GetAsset sampai status menjadi Active, lalu gunakan ID material yang dikembalikan untuk pembuatan video.