Seedance Private Assets gebruiken met de Seedance API

Seedance Private Asset Library workflow voor herbruikbare videoreferenties
PiAPI
PiAPI

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: true voor tijdelijke user references in één task.
  • Een private asset moet Active zijn voordat je het in Seedance gebruikt.
  • asset:// werkt met seedance-2-less-restriction en seedance-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

PatroonBeste voorVoorbeeldWanneer gebruiken
Managed private assetTerugkerende personen, personages, productenasset://asset-123Als dezelfde referentie in meerdere tasks komt.
Raw URLEenmalige achtergrond, scene of prophttps://your-cdn.com/scene.jpgAls de referentie alleen nu nodig is.
Auto-uploaded ephemeral assetTijdelijke user referenceURL + auto_upload_assets: trueAls 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

  1. Upload de herbruikbare referentie.
  2. Wacht tot de status Active is.
  3. Verstuur een Seedance task met asset://<asset_id> in image_urls, video_urls of audio_urls.
  4. Gebruik in de prompt Image 1, Image 2, Video 1 of Audio 1 volgens de inputvolgorde.
  5. 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 1 en Image 2.
  • Wacht op Active voordat 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.

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