Seedance API ile Seedance Private Assets nasıl kullanılır

PiAPI artık yeniden kullanılabilir referansları yükleyip daha sonra asset://<asset_id> ile çağırmaya yarayan Seedance API workflow'u Seedance Private Asset Library'yi destekliyor.
Seedance Private Asset Library; yüz, karakter, ürün, sahne, video veya ses referanslarını Seedance API task'lerinde tekrar kullanmanızı sağlar. Bu özellik reusable reference ve character consistency içindir; klasik face swap, inpainting veya pixel-perfect image editing değildir.
Öne çıkanlar
- Aynı yüz, karakter, ürün veya konu birden fazla gelecekteki videoda yer alacaksa private assets kullanın.
- Tek seferlik arka plan, sahne, prop veya referanslar için raw URL kullanın.
- Tek task için geçici kullanıcı referansı gerekiyorsa
auto_upload_assets: truekullanın. - Asset, Seedance task içinde kullanılmadan önce
Activeolmalıdır. asset://,seedance-2-less-restrictionveseedance-2-fast-less-restrictionile çalışır; strict task types ile çalışmaz.
Hızlı cevap
Seedance private assets, Seedance API'de yeniden kullanılabilir referanslar için en iyi seçenektir. Referansı bir kez yükleyin, Active olmasını bekleyin ve sonraki video task'lerinde asset://<asset_id> ile kullanın.
Seedance Private Assets nedir?
Uygulamanızın video generation öncesinde PiAPI'ye yüklediği yeniden kullanılabilir dosyalardır. Upload sonrası PiAPI bir asset_id döndürür. Asset Active olduğunda Seedance API request içinde asset://<asset_id> olarak kullanılabilir. Endpoint, quota ve lifecycle detayları Private Asset Library docs içindedir.
Hangi problemi çözer?
AI video generation, aynı konunun birden fazla prompt, sahne veya creative variation boyunca tutarlı kalması gerektiğinde zorlaşır. Raw image URL tek task için işe yarar, ancak sık yeniden kullanım için ideal değildir.
Yaygın kullanım alanları: aynı kişi veya karakteri korumak, avatar/influencer video ürünleri yapmak, reklam varyasyonlarında ürün referansını yeniden kullanmak, kısa hikayelerde sabit cast kullanmak ve backend'de tekrar upload işini azaltmak. Model özeti için Seedance 2.0 API guide sayfasına bakın.
Private Assets ne değildir?
Seedance Private Asset Library face swap, inpainting veya tam fotoğraf compositing değildir. Seedance input'ları generation reference olarak kullanır. Sonuç, referansla yönlendirilen generated video'dur; pixel-level edit değildir.
Private Assets vs Raw URL vs Auto-Upload
| Pattern | En uygun | Örnek | Ne zaman kullanılır |
|---|---|---|---|
| Managed private asset | Tekrarlanan kişiler, karakterler, ürünler | asset://asset-123 | Aynı referans birden fazla task'te kullanılacaksa. |
| Raw URL | Tek seferlik arka plan, sahne, prop | https://your-cdn.com/scene.jpg | Referans sadece mevcut task içinse. |
| Auto-uploaded ephemeral asset | Geçici kullanıcı referansı | URL + auto_upload_assets: true | PiAPI'nin geçici ingest yapması gerekiyorsa. |
Basit kural: referans tekrar kullanılacaksa private asset yapın; bir kez gerekiyorsa raw URL veya auto-upload kullanın.
Workflow
- Reusable reference yükleyin.
- Status
Activeolana kadar bekleyin. image_urls,video_urlsveyaaudio_urlsiçindeasset://<asset_id>ile Seedance task gönderin.- Prompt içinde input sırasına göre
Image 1,Image 2,Video 1veyaAudio 1yazın. - Video bitene kadar task'i poll edin.
{
"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."
}API örneği
https://api.piapi.ai/api/v1/asset/upload ile referansı yükleyin, asset list endpoint ile status kontrol edin ve Active olduğunda seedance-2-less-restriction veya seedance-2-fast-less-restriction task içinde asset://<asset_id> kullanın. seedance-2 ve seedance-2-fast gibi strict variants private asset references desteklemez.
Best practices
- Tekrarlanan yüz, ana karakter, ürün veya marka konusu için private assets kullanın.
- Tek seferlik arka planları raw URL olarak bırakın.
- Prompt'ta
Image 1,Image 2gibi net label kullanın. - Generation öncesi
Activebekleyin. - Quota, TTL ve user reference consent planlayın.
FAQ
Seedance private asset nedir?
Seedance video generation için PiAPI'ye yüklenen yeniden kullanılabilir referanstır. Active olunca asset://<asset_id> ile kullanılabilir.
Yüz fotoğrafını tekrar kullanabilir miyim?
Evet, reference-guided generation olarak. Bu exact face swap garantisi değildir.
Sonuç
Seedance Private Asset Library, Seedance API ile reusable reference workflow kurmanın daha temiz bir yoludur. Bir referans yükleyin, Active olduğunu doğrulayın, sonra asset, prompt ve tek seferlik raw URLs ile less-restriction task gönderin. Seedance workspace üzerinden test edebilirsiniz.

