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 material

Tujuan	Alur wajib
Memakai URL gambar satu kali	Kirim URL langsung dalam request video; model kompatibel menyiapkan material otomatis
Menggunakan ulang avatar, produk, atau gaya	Buat grup `aigc_avatar` dan material, tunggu `ACTIVE`, lalu gunakan ID
Menggunakan ulang orang asli	Selesaikan verifikasi visual, dapatkan `GroupId`, buat material, tunggu `ACTIVE`, lalu gunakan ID
Memigrasikan klien material Volcengine	Pertahankan bentuk Action dan gunakan referensi kompatibel Volcengine: Action material kompatibel Volcengine

Konsep Materi

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

Konsep	Bidang publik	Apa artinya
Grup materi	`group_id`	Grup TokenLab yang memiliki materi Seedance terkait. Gunakan saat mengunggah atau mencantumkan materi.
Aset materi	`id`	Satu file gambar, video, atau audio yang diunggah. Gunakan nilai ini sebagai `material_asset_id` setelah aset menjadi `ACTIVE`.
Grup materi avatar virtual	`library_type: "aigc_avatar"`	Untuk orang virtual, avatar, produk, gaya, dan referensi lain yang dapat digunakan kembali yang tidak memerlukan verifikasi orang asli.
Grup materi orang asli	`library_type: "liveness_face"`	Dibuat melalui verifikasi materi orang asli. Satu grup mewakili satu orang asli yang terverifikasi.

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".

Material Gambar Otomatis

Jika model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, Anda dapat mengirim URL gambar atau data URL inline yang didukung langsung di image, image_url, image_urls, reference_images, start_image, atau end_image. TokenLab mengimpor gambar tersebut ke grup material avatar virtual default organisasi dan mempertahankan perannya sebagai frame pertama, frame terakhir, atau gambar referensi. Jika material menjadi ACTIVE dalam 60 detik, generasi berlanjut dalam request yang sama. Jika belum siap, API mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids; lihat material tersebut sampai ACTIVE, lalu coba lagi dengan material_asset_id atau material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, URL gambar atau data URL biasa tetap berada di jalur gambar normal; ID material eksplisit gagal secara aman dengan error ketersediaan material yang dapat dicoba ulang. ID material avatar virtual atau real-person yang sudah ada digunakan apa adanya dan tidak diimpor ulang.

Verifikasi Materi Orang Asli

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.

Panggil Membuat sesi validasi visual dengan CallbackURL dan simpan Result.BytedToken yang dikembalikan.
Buka Result.H5Link untuk orang yang akan diverifikasi. Tambahkan lng ke tautan H5 jika Anda memerlukan bahasa tertentu.
Setelah alur H5 selesai, browser membuka Result.CallbackURL dengan nama kueri resmi seperti bytedToken dan resultCode.
Lakukan polling Mendapatkan hasil validasi visual dengan BytedToken hingga Result.GroupId dikembalikan.
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. 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 Materi

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 Materi

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.

Tipe	Input yang didukung
Gambar	`jpeg`, `png`, `webp`, `bmp`, `tiff`, `gif`, `heic`, `heif`; rasio aspek `(0.4, 2.5)`; lebar dan tinggi `(300, 6000)` px; di bawah 30 MB.
Video	`mp4`, `mov`; `480p`, `720p`, atau `1080p`; 2-15 detik; rasio aspek `[0.4, 2.5]`; lebar dan tinggi `[300, 6000]` px; total piksel antara 409600 dan 2068676; hingga 200 MB; 24-60 FPS.
Audio	`aac`, `wav`, `mp3`; 2-15 detik; hingga 15 MB.

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. 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 Video

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 Volcengine

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 API

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 asli

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.

Memulai

Panduan inti

Panduan media

Material Seedance dan verifikasi orang asli

Pilih alur material

Konsep Materi

Material Gambar Otomatis

Verifikasi Materi Orang Asli

Membuat Grup Materi

Mengunggah Materi

Menggunakan Materi dalam Pembuatan Video

REST atau Action Volcengine

Contoh API

Alur Action lengkap untuk orang asli

​Pilih alur material

​Konsep Materi

​Material Gambar Otomatis

​Verifikasi Materi Orang Asli

​Membuat Grup Materi

​Mengunggah Materi

​Menggunakan Materi dalam Pembuatan Video

​REST atau Action Volcengine

​Contoh API

​Alur Action lengkap untuk orang asli

Pilih alur material

Konsep Materi

Material Gambar Otomatis

Verifikasi Materi Orang Asli

Membuat Grup Materi

Mengunggah Materi

Menggunakan Materi dalam Pembuatan Video

REST atau Action Volcengine

Contoh API

Alur Action lengkap untuk orang asli