Jak używać Seedance Private Assets z Seedance API

PiAPI obsługuje teraz Seedance Private Asset Library, workflow Seedance API do przesyłania referencji wielokrotnego użytku i późniejszego wywoływania ich przez asset://<asset_id>.
Seedance Private Asset Library pozwala przesłać twarz, postać, produkt, scenę, wideo lub audio i ponownie używać ich w zadaniach Seedance API. To rozwiązanie jest przeznaczone do reusable references i character consistency, a nie do klasycznego face swap, inpainting czy pixel-perfect edycji obrazów.
Najważniejsze punkty
- Użyj private assets, gdy ta sama twarz, postać, produkt lub temat ma pojawiać się w wielu przyszłych filmach.
- Używaj raw URL dla jednorazowych teł, scen, props lub referencji.
- Użyj
auto_upload_assets: true, gdy tymczasowa referencja użytkownika ma być użyta w jednym tasku. - Asset musi mieć status
Active, zanim zostanie użyty w Seedance. asset://działa zseedance-2-less-restrictioniseedance-2-fast-less-restriction, nie ze strict task types.
Szybka odpowiedź
Seedance private assets są najlepsze dla referencji wielokrotnego użytku w Seedance API. Prześlij referencję raz, poczekaj na Active, a potem używaj jej w kolejnych zadaniach wideo przez asset://<asset_id>.
Czym są Seedance Private Assets?
To pliki wielokrotnego użytku, które aplikacja przesyła do PiAPI przed generowaniem wideo. Po uploadzie PiAPI zwraca asset_id. Gdy asset stanie się Active, request Seedance API może użyć asset://<asset_id>. Szczegóły endpointów, quota i lifecycle są w Private Asset Library docs.
Jaki problem rozwiązują?
AI video generation bywa trudne, gdy ten sam temat musi pozostać spójny w wielu promptach, scenach lub wariantach kreatywnych. Raw image URL pomaga w jednym zadaniu, ale nie jest idealny do częstego ponownego użycia.
Typowe use case'y to spójność osoby lub postaci, produkty avatar/influencer, ponowne użycie referencji produktu w reklamach, stabilna obsada w krótkich historiach i mniej powtarzalnych uploadów w backendzie. Kontekst modelu znajdziesz w Seedance 2.0 API guide.
Czym Private Assets nie są
Seedance Private Asset Library nie jest face swapem, inpaintingiem ani dokładnym fotomontażem. Seedance używa inputów jako generation references. Wynik to wideo prowadzone referencją, nie precyzyjna edycja obrazu.
Private Assets vs Raw URL vs Auto-Upload
| Wzorzec | Najlepsze dla | Przykład | Kiedy używać |
|---|---|---|---|
| Managed private asset | Powtarzalne osoby, postacie, produkty | asset://asset-123 | Gdy ta sama referencja ma być używana w wielu taskach. |
| Raw URL | Jednorazowe tło, scena lub prop | https://your-cdn.com/scene.jpg | Gdy referencja jest ważna tylko dla obecnego taska. |
| Auto-uploaded ephemeral asset | Tymczasowa referencja użytkownika | URL + auto_upload_assets: true | Gdy PiAPI ma tymczasowo ingestować plik. |
Prosta zasada: jeśli referencja będzie używana ponownie, zrób private asset; jeśli tylko raz, użyj raw URL lub auto-upload.
Workflow
- Prześlij reusable reference.
- Poczekaj na status
Active. - Wyślij Seedance task z
asset://<asset_id>wimage_urls,video_urlslubaudio_urls. - W prompt używaj
Image 1,Image 2,Video 1lubAudio 1zgodnie z kolejnością inputów. - Polluj task do zakończenia filmu.
{
"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."
}Przykład API
Prześlij referencję przez https://api.piapi.ai/api/v1/asset/upload, sprawdź status przez asset list endpoint, a po Active użyj asset://<asset_id> w tasku seedance-2-less-restriction lub seedance-2-fast-less-restriction. Strict warianty seedance-2 i seedance-2-fast nie obsługują private asset references.
Best practices
- Używaj private assets dla powtarzalnych twarzy, głównych postaci, produktów lub brand subjects.
- Jednorazowe tła zostaw jako raw URLs.
- Używaj jasnych labeli w prompt:
Image 1,Image 2. - Poczekaj na
Activeprzed generowaniem. - Zaplanuj quota, TTL i zgodę na użycie referencji użytkownika.
FAQ
Czym jest Seedance private asset?
To referencja wielokrotnego użytku przesłana do PiAPI dla Seedance video generation. Po Active używa się jej przez asset://<asset_id>.
Czy mogę ponownie używać zdjęcia twarzy?
Tak, jako reference-guided generation. To nie gwarantuje dokładnego face swap.
Podsumowanie
Seedance Private Asset Library daje developerom czystszy sposób budowy reusable reference workflows z Seedance API. Prześlij referencję, potwierdź Active, potem wyślij less-restriction task z assetem, promptem i jednorazowymi raw URLs. Testować możesz w Seedance workspace.

