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

Yeniden kullanılabilir video referansları için Seedance Private Asset Library workflow
PiAPI
PiAPI

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: true kullanın.
  • Asset, Seedance task içinde kullanılmadan önce Active olmalıdır.
  • asset://, seedance-2-less-restriction ve seedance-2-fast-less-restriction ile ç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

PatternEn uygunÖrnekNe zaman kullanılır
Managed private assetTekrarlanan kişiler, karakterler, ürünlerasset://asset-123Aynı referans birden fazla task'te kullanılacaksa.
Raw URLTek seferlik arka plan, sahne, prophttps://your-cdn.com/scene.jpgReferans sadece mevcut task içinse.
Auto-uploaded ephemeral assetGeçici kullanıcı referansıURL + auto_upload_assets: truePiAPI'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

  1. Reusable reference yükleyin.
  2. Status Active olana kadar bekleyin.
  3. image_urls, video_urls veya audio_urls içinde asset://<asset_id> ile Seedance task gönderin.
  4. Prompt içinde input sırasına göre Image 1, Image 2, Video 1 veya Audio 1 yazın.
  5. 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 2 gibi net label kullanın.
  • Generation öncesi Active bekleyin.
  • 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.

More Stories

What Is Seedance 2.5? ByteDance's AI Video Model Explained

June 25, 2026

Learn what Seedance 2.5 is, what the new model adds, whether the Seedance 2.5 API is available, and how to prepare with PiAPI.

PiAPI
PiAPI

How to Create a Korean Baseball AI Trend Video From Your Photo

June 17, 2026

Use an AI sports video generator to turn a photo into a Korean baseball-style image, review it, then animate it into an AI baseball trend video.

PiAPI
PiAPI