Przejdź do głównej treści
Seedance 2.0 generuje wideo na podstawie zaufanych zasobów referencyjnych — twarzy, stroju, produktu, głosu. Aby generowanie pozostawało spójne i zgodne z przepisami, te referencje znajdują się w prywatnej bibliotece zasobów, której model ufa w czasie wnioskowania. OrcaRouter udostępnia tę bibliotekę pod /v1/asset. Ta strona wyjaśnia, jak działa biblioteka i czego wymaga. Dokładne punkty końcowe, parametry oraz konsolę do testowania znajdziesz w API Reference → Seedance Assets.

​
Jak zorganizowana jest biblioteka

  • Grupa zasobów (Asset Group) — kontener. W przypadku grupy rzeczywistej osoby jedna grupa odpowiada jednej realnej osobie; w przypadku grupy wirtualnej jest to grupowanie logiczne (np. jedna postać).
  • Zasób (Asset) — pojedynczy plik (obraz, wideo lub audio) wewnątrz grupy. Tylko zasoby, które osiągną status Active, mogą być wykorzystane w generowaniu wideo.
Do gotowego zasobu odwołujesz się w żądaniu wideo jako asset://<asset_id>.

​
Dwa rodzaje grup

Operacje przesyłania i zarządzania są identyczne dla obu; różnią się tylko sposobem tworzenia grupy.
Wirtualna (AIGC)Rzeczywista osoba (LivenessFace)
ZastosowanieFikcyjne / AI postacie, rekwizyty, scenyWizerunek rzeczywistej osoby
Tworzona przezBezpośrednie wywołanie tworząceJednorazową weryfikację twarzy wykonaną przez tę osobę
DlaczegoBrak tożsamości do ochronyPrawo do wizerunku — zgoda jest pozyskiwana u źródła
Obie biblioteki wymagają Advanced Creation Rights; limit pojemności jest współdzielony między nimi. Biblioteka rzeczywistych osób jest dostępna dla zaproszonych kont.

​
Wymagania dotyczące plików zasobów

Zasoby są dostarczane jako publicznie dostępny adres URL (bez przesyłania plików, bez base64). Ograniczenia:
TypFormatyOgraniczenia
Obrazjpeg, png, webp, bmp, tiff, gif, heic/heifproporcje (W/H) 0.4–2.5 · 300–6000 px na bok · < 30 MB
Wideomp4, mov480p/720p/1080p · 2–15 s · proporcje 0.4–2.5 · 300–6000 px · łącznie pikseli 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Audiowav, mp32–15 s · ≤ 15 MB
Treści portretowe, najlepsze praktyki (dla spójności twarzy):
  • Referencja całej sylwetki: pionowe, frontalne ujęcie całej postaci.
  • Zbliżenie twarzy: pionowe, neutralny wyraz, kadr powyżej ramion, twarz wypełniająca mniej więcej dwie trzecie kadru.
Przesłanie kilku dobrych referencji tej samej osoby do jednej grupy poprawia wierność, z jaką wygenerowane wideo odtwarza jej twarz i ubiór.

​
Cykl życia zasobu (przesyłanie jest asynchroniczne)

Przesłanie zasobu zwraca natychmiast asset_id; plik jest następnie przetwarzany wstępnie w tle. Odpytuj zasób, aż jego Status się ustabilizuje:
  • Processing — wciąż trwa przetwarzanie wstępne; kontynuuj odpytywanie.
  • Active — gotowy; użyj go w generowaniu wideo.
  • Failed — przetwarzanie wstępne go odrzuciło; sprawdź Error (np. format/rozmiar, blokada moderacji treści, lub — w przypadku grup rzeczywistych osób — FaceMismatch).
Czas przesyłania nie jest objęty gwarantowanym SLA; zasoby wideo trwają dłużej niż obrazy. Podpisany adres URL do pobrania zwracany dla zasobu jest tymczasowy (~12 godzin).

​
Proces weryfikacji rzeczywistej osoby

Grupa rzeczywistej osoby jest tworzona przez jednorazową weryfikację wykonaną przez tę osobę. Twój backend nigdy nie przetwarza jej danych twarzy — jedynie orkiestruje proces:
1

Rozpocznij sesję

Twój backend prosi OrcaRouter o rozpoczęcie sesji weryfikacji. W odpowiedzi otrzymujesz link H5 (hostowaną stronę kontroli twarzy) oraz session_id.
2

Osoba przechodzi weryfikację

Przekazujesz link H5 użytkownikowi końcowemu. Otwiera go na własnym urządzeniu — bez konieczności logowania do OrcaRouter — i wykonuje kontrolę twarzy. Autoryzuje raz; później nowe wcielenia tej samej osoby można dodać do tej samej grupy bez ponownej weryfikacji.
3

Grupa zostaje utworzona

Po sukcesie strona weryfikacji przekierowuje przeglądarkę użytkownika końcowego z powrotem do wywołania zwrotnego OrcaRouter (obsługiwanego automatycznie), a nowa grupa zostaje zarejestrowana. Jeśli przekazałeś return_url, użytkownik wraca na Twoją stronę.
4

Odpytuj o wynik

Twój backend odpytuje sesję, aż status będzie success (z nowym group_id) lub failed. Następnie przesyłasz zasoby i generujesz wideo dokładnie tak jak dla grupy wirtualnej.
Spójność twarzy. Gdy przesyłasz obraz do grupy rzeczywistej osoby, jest on porównywany z zweryfikowaną referencją. Inna osoba (lub wiele twarzy na jednym obrazie) zostaje odrzucona — zasób przechodzi w Failed / FaceMismatch. Nazwę i opis grupy można ustawić po utworzeniu za pomocą operacji aktualizacji grupy.

​
Limit

Twoje konto ma maksymalną liczbę zasobów (domyślnie 100, łącznie we wszystkich grupach). Przesyłanie powyżej limitu jest odrzucane kodem 403.

​
Odwoływanie się do zasobu w generowaniu wideo

Gdy zasób jest Active, odwołaj się do niego przez asset://<asset_id> w polu metadata.content[] żądania wideo Seedance i wskaż go w prompcie przez typ + pozycję ([Image 1], [Video 1], [Audio 1]) — nigdy przez surowe asset id: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
Dalej

  • API Reference → Seedance Assets — każdy punkt końcowy, pełne parametry i interaktywny plac zabaw (tutaj znajdują się przykłady żądań/odpowiedzi).
  • Seedance Video — punkt końcowy generowania wideo, który konsumuje te zasoby.