Cara memakai Seedance Private Assets dengan Seedance API

PiAPI kini mendukung Seedance Private Asset Library, workflow Seedance API untuk mengunggah referensi yang bisa dipakai ulang dan memanggilnya lagi dengan asset://<asset_id>.
Fitur ini cocok untuk referensi wajah, karakter, produk, scene, video, atau audio yang dipakai berulang dalam tugas Seedance API. Tujuannya adalah reusable reference dan character consistency, bukan face swap klasik, inpainting, atau editing gambar pixel-perfect.
Poin utama
- Gunakan private assets saat wajah, karakter, produk, atau subjek perlu muncul di banyak video berikutnya.
- Gunakan raw URL untuk background, scene, prop, atau referensi sekali pakai.
- Gunakan
auto_upload_assets: trueuntuk referensi sementara dari user dalam satu task. - Asset harus berstatus
Activesebelum dipakai di task Seedance. asset://bekerja denganseedance-2-less-restrictiondanseedance-2-fast-less-restriction, bukan task type strict.
Jawaban cepat
Seedance private assets paling cocok untuk referensi reusable di Seedance API. Upload sekali, tunggu Active, lalu pakai di task video berikutnya dengan asset://<asset_id>.
Apa itu Seedance Private Assets?
Seedance private assets adalah file reusable yang diunggah aplikasi Anda ke PiAPI sebelum video generation. Setelah upload, PiAPI mengembalikan asset_id. Saat asset menjadi Active, request Seedance API bisa memakai format asset://<asset_id>. Detail endpoint, quota, dan lifecycle ada di Private Asset Library docs.
Masalah yang diselesaikan
AI video generation sering sulit menjaga subjek yang sama tetap konsisten di banyak prompt, scene, atau variasi kreatif. Raw image URL bisa membantu untuk satu task, tetapi kurang ideal untuk penggunaan berulang.
Use case umum termasuk menjaga orang atau karakter tetap konsisten, membuat produk avatar atau influencer, memakai ulang referensi produk untuk variasi iklan, menjaga cast stabil untuk short film, dan mengurangi upload berulang di backend. Untuk overview model, lihat Seedance 2.0 API guide.
Bukan face swap
Seedance Private Asset Library bukan face swap, inpainting, atau photo compositing presisi. Seedance memakai input sebagai generation references. Hasilnya adalah video yang dipandu referensi, bukan edit gambar presisi.
Private Assets vs Raw URL vs Auto-Upload
| Pola | Terbaik untuk | Contoh | Kapan dipakai |
|---|---|---|---|
| Managed private asset | Orang, karakter, produk, atau subjek berulang | asset://asset-123 | Saat referensi akan dipakai di banyak task. |
| Raw URL | Background, scene, atau prop sekali pakai | https://your-cdn.com/scene.jpg | Saat referensi hanya penting untuk task sekarang. |
| Auto-uploaded ephemeral asset | Referensi user sementara | URL + auto_upload_assets: true | Saat PiAPI perlu ingest sementara. |
Aturan sederhana: kalau referensi akan dipakai lagi, jadikan private asset. Kalau hanya sekali, gunakan raw URL atau auto-upload.
Workflow
- Upload referensi reusable.
- Tunggu status
Active. - Submit task Seedance dengan
asset://<asset_id>diimage_urls,video_urls, atauaudio_urls. - Di prompt, gunakan label
Image 1,Image 2,Video 1, atauAudio 1sesuai urutan input. - Poll task sampai video selesai.
{
"image_urls": ["asset://asset-person-reference", "https://your-cdn.com/scenic-background.jpg"],
"prompt": "Image 1 is the person reference. Image 2 is the scenic background. Generate a cinematic 5-second video."
}Contoh API
Upload referensi melalui https://api.piapi.ai/api/v1/asset/upload, cek status lewat asset list endpoint, lalu setelah Active, gunakan asset://<asset_id> dalam task seedance-2-less-restriction atau seedance-2-fast-less-restriction. Varian strict seperti seedance-2 dan seedance-2-fast tidak mendukung private asset references.
Praktik terbaik
- Pakai private assets untuk wajah, karakter utama, produk, atau brand subject yang berulang.
- Simpan background sekali pakai sebagai raw URL.
- Gunakan label prompt yang jelas seperti
Image 1danImage 2. - Tunggu
Activesebelum generation. - Rencanakan quota, TTL, dan persetujuan penggunaan referensi user.
FAQ
Apa itu Seedance private asset?
Referensi reusable yang diunggah ke PiAPI untuk Seedance video generation. Saat Active, referensi dapat dipakai dengan asset://<asset_id>.
Bisa upload foto wajah dan dipakai ulang?
Bisa, sebagai reference-guided generation. Ini bukan jaminan face swap presisi.
Kesimpulan
Seedance Private Asset Library membantu developer membuat workflow referensi reusable yang lebih rapi dengan Seedance API. Upload satu referensi, pastikan Active, lalu submit task less-restriction dengan asset, prompt, dan raw URL sekali pakai. Anda bisa mencoba di Seedance workspace.

