Seedance Private Assets gebruiken met de Seedance API

PiAPI ondersteunt nu Seedance Private Asset Library, een Seedance API-workflow om herbruikbare referenties te uploaden en later aan te roepen met asset://<asset_id>.
Seedance Private Asset Library laat je gezichten, personages, producten, scenes, video of audio uploaden en opnieuw gebruiken in Seedance API-taken. Het is bedoeld voor herbruikbare referenties en character consistency, niet voor klassieke face swap, inpainting of pixel-perfect beeldbewerking.
Belangrijkste punten
- Gebruik private assets wanneer hetzelfde gezicht, personage, product of onderwerp in meerdere toekomstige video's moet verschijnen.
- Gebruik raw URLs voor eenmalige achtergronden, scenes, props of referenties.
- Gebruik
auto_upload_assets: truevoor tijdelijke user references in één task. - Een private asset moet
Activezijn voordat je het in Seedance gebruikt. asset://werkt metseedance-2-less-restrictionenseedance-2-fast-less-restriction, niet met strict task types.
Kort antwoord
Seedance private assets zijn ideaal voor herbruikbare referenties in de Seedance API. Upload de referentie één keer, wacht op Active, en gebruik deze in latere videotaken met asset://<asset_id>.
Wat zijn Seedance Private Assets?
Het zijn herbruikbare bestanden die je applicatie naar PiAPI uploadt vóór videogeneratie. Na upload retourneert PiAPI een asset_id. Zodra het asset Active is, kunnen Seedance API requests het gebruiken als asset://<asset_id>. Details over endpoints, quota en lifecycle staan in de Private Asset Library docs.
Welk probleem lossen ze op?
AI-videogeneratie wordt lastig wanneer hetzelfde onderwerp consistent moet blijven over meerdere prompts, scenes of creatieve variaties. Een raw image URL werkt voor één task, maar is minder geschikt voor veelvuldig hergebruik.
Veelvoorkomende use cases zijn dezelfde persoon of hetzelfde personage behouden, avatar- of influencerproducten bouwen, productreferenties hergebruiken in advertenties, een stabiele cast behouden en herhaalde backend uploads verminderen. Lees voor modelcontext de Seedance 2.0 API guide.
Wat zijn ze niet?
Seedance Private Asset Library is geen face swap, inpainting of exacte fotocompositie. Seedance gebruikt inputs als generation references. Het resultaat is referentiegestuurde video, geen exacte beeldedit.
Private Assets vs Raw URL vs Auto-Upload
| Patroon | Beste voor | Voorbeeld | Wanneer gebruiken |
|---|---|---|---|
| Managed private asset | Terugkerende personen, personages, producten | asset://asset-123 | Als dezelfde referentie in meerdere tasks komt. |
| Raw URL | Eenmalige achtergrond, scene of prop | https://your-cdn.com/scene.jpg | Als de referentie alleen nu nodig is. |
| Auto-uploaded ephemeral asset | Tijdelijke user reference | URL + auto_upload_assets: true | Als PiAPI tijdelijk moet ingesteren. |
Simpele regel: wordt de referentie hergebruikt, maak er een private asset van; is het eenmalig, gebruik raw URL of auto-upload.
Workflow
- Upload de herbruikbare referentie.
- Wacht tot de status
Activeis. - Verstuur een Seedance task met
asset://<asset_id>inimage_urls,video_urlsofaudio_urls. - Gebruik in de prompt
Image 1,Image 2,Video 1ofAudio 1volgens de inputvolgorde. - Poll de task tot de video klaar is.
{
"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-voorbeeld
Upload de referentie via https://api.piapi.ai/api/v1/asset/upload, check de status met het asset list endpoint en gebruik na Active asset://<asset_id> in een seedance-2-less-restriction of seedance-2-fast-less-restriction task. Strict varianten zoals seedance-2 en seedance-2-fast ondersteunen geen private asset references.
Best practices
- Gebruik private assets voor terugkerende gezichten, hoofdpersonages, producten of merksubjecten.
- Laat eenmalige achtergronden raw URLs blijven.
- Gebruik duidelijke promptlabels zoals
Image 1enImage 2. - Wacht op
Activevoordat je genereert. - Plan quota, TTL en toestemming voor user references.
FAQ
Wat is een Seedance private asset?
Een herbruikbare referentie die naar PiAPI is geüpload voor Seedance-videogeneratie. Zodra deze Active is, gebruik je asset://<asset_id>.
Kan ik een gezichtsfoto hergebruiken?
Ja, als reference-guided generation. Het garandeert geen exacte face swap.
Conclusie
Seedance Private Asset Library geeft developers een schonere manier om herbruikbare referentieworkflows met de Seedance API te bouwen. Upload een referentie, bevestig Active, en verstuur een less-restriction task met asset, prompt en eenmalige raw URLs. Testen kan in de Seedance workspace.

