Jak używać Seedance Private Assets z Seedance API

Workflow Seedance Private Asset Library dla wielokrotnego użytku video references
PiAPI
PiAPI

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 z seedance-2-less-restriction i seedance-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

WzorzecNajlepsze dlaPrzykładKiedy używać
Managed private assetPowtarzalne osoby, postacie, produktyasset://asset-123Gdy ta sama referencja ma być używana w wielu taskach.
Raw URLJednorazowe tło, scena lub prophttps://your-cdn.com/scene.jpgGdy referencja jest ważna tylko dla obecnego taska.
Auto-uploaded ephemeral assetTymczasowa referencja użytkownikaURL + auto_upload_assets: trueGdy 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

  1. Prześlij reusable reference.
  2. Poczekaj na status Active.
  3. Wyślij Seedance task z asset://<asset_id> w image_urls, video_urls lub audio_urls.
  4. W prompt używaj Image 1, Image 2, Video 1 lub Audio 1 zgodnie z kolejnością inputów.
  5. 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 Active przed 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.

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