Zum Hauptinhalt springen
Seedance 2.0 erzeugt Video aus vertrauenswürdigen Referenz-Assets — einem Gesicht, einem Outfit, einem Produkt, einer Stimme. Damit die Generierung konsistent und konform bleibt, liegen diese Referenzen in einer privaten Asset-Bibliothek, der das Modell zur Inferenzzeit vertraut. OrcaRouter stellt diese Bibliothek unter /v1/asset bereit. Diese Seite erklärt, wie die Bibliothek funktioniert und was erforderlich ist. Für die genauen Endpunkte, Parameter und eine Try-it-Konsole siehe API Reference → Seedance Assets.

​
Wie die Bibliothek aufgebaut ist

  • Asset-Gruppe — ein Container. Bei einer Echtmenschen-Gruppe entspricht eine Gruppe einer realen Person; bei einer virtuellen Gruppe ist es eine logische Gruppierung (z. B. eine Figur).
  • Asset — eine einzelne Datei (Bild, Video oder Audio) innerhalb einer Gruppe. Nur Assets, die den Status Active erreichen, können in der Videogenerierung referenziert werden.
Ein bereitstehendes Asset referenzierst du in einer Videoanfrage als asset://<asset_id>.

​
Zwei Arten von Gruppen

Die Upload- und Verwaltungsoperationen sind für beide identisch; sie unterscheiden sich nur darin, wie die Gruppe erstellt wird.
Virtuell (AIGC)Echtmensch (LivenessFace)
Verwendung fürFiktive / KI-Figuren, Requisiten, SzenenDas Abbild einer realen Person
Erstellt durchEinen direkten ErstellungsaufrufEine einmalige Gesichtsverifizierung durch diese Person
WarumKeine Identität zu schützenPersönlichkeitsrechte — die Einwilligung wird an der Quelle erfasst
Beide Bibliotheken erfordern Advanced Creation Rights; das Kapazitätskontingent wird zwischen ihnen geteilt. Die Echtmenschen-Bibliothek steht eingeladenen Konten zur Verfügung.

​
Asset-Dateianforderungen

Assets werden als öffentlich zugängliche URL bereitgestellt (kein Datei-Upload, kein base64). Limits:
TypFormateEinschränkungen
Bildjpeg, png, webp, bmp, tiff, gif, heic/heifSeitenverhältnis (B/H) 0.4–2.5 · 300–6000 px pro Seite · < 30 MB
Videomp4, mov480p/720p/1080p · 2–15 s · Verhältnis 0.4–2.5 · 300–6000 px · Gesamtpixel 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Audiowav, mp32–15 s · ≤ 15 MB
Porträtinhalte, Best Practices (für Gesichtskonsistenz):
  • Ganzkörper-Referenz: vertikale, frontale Ganzkörperaufnahme der Person.
  • Gesichts-Nahaufnahme: vertikal, neutraler Gesichtsausdruck, Ausschnitt oberhalb der Schultern, das Gesicht füllt etwa zwei Drittel des Bildes.
Mehrere gute Referenzen derselben Person in eine Gruppe hochzuladen verbessert, wie originalgetreu das generierte Video ihr Gesicht und ihre Kleidung reproduziert.

​
Asset-Lebenszyklus (Upload ist asynchron)

Der Upload eines Assets gibt sofort eine asset_id zurück; die Datei wird anschließend im Hintergrund vorverarbeitet. Frage das Asset ab, bis sich sein Status stabilisiert:
  • Processing — wird noch vorverarbeitet; weiter abfragen.
  • Active — bereit; in der Videogenerierung verwenden.
  • Failed — die Vorverarbeitung hat es abgelehnt; prüfe Error (z. B. Format/Größe, eine Sperre durch die Inhaltsmoderation oder — bei Echtmenschen-Gruppen — FaceMismatch).
Für die Upload-Dauer gibt es keine garantierte SLA; Video-Assets dauern länger als Bilder. Die für ein Asset zurückgegebene signierte Download-URL ist temporär (~12 Stunden).

​
Echtmenschen-Verifizierungsablauf

Eine Echtmenschen-Gruppe wird erstellt, indem sich die Person einmalig verifiziert. Dein Backend verarbeitet niemals ihre Gesichtsdaten — es orchestriert lediglich den Ablauf:
1

Eine Sitzung starten

Dein Backend bittet OrcaRouter, eine Verifizierungssitzung zu starten. Du erhältst einen H5-Link (eine gehostete Gesichtsprüfungsseite) und eine session_id.
2

Die Person verifiziert sich

Du übergibst den H5-Link an den Endnutzer. Er öffnet ihn auf seinem eigenen Gerät — kein OrcaRouter-Login erforderlich — und schließt die Gesichtsprüfung ab. Sie autorisieren einmal; später können neue Looks derselben Person ohne erneute Verifizierung zur selben Gruppe hinzugefügt werden.
3

Die Gruppe wird erstellt

Bei Erfolg leitet die Verifizierungsseite den Browser des Endnutzers zurück zu einem OrcaRouter-Callback (automatisch verarbeitet) um, und die neue Gruppe wird für dich registriert. Wenn du eine return_url übergeben hast, landet der Nutzer wieder auf deiner Seite.
4

Auf das Ergebnis abfragen

Dein Backend fragt die Sitzung ab, bis status success (mit der neuen group_id) oder failed ist. Dann lädst du Assets hoch und generierst Video genau wie bei einer virtuellen Gruppe.
Gesichtskonsistenz. Wenn du ein Bild in eine Echtmenschen-Gruppe hochlädst, wird es mit der verifizierten Referenz verglichen. Eine andere Person (oder mehrere Gesichter in einem Bild) wird abgelehnt — das Asset wird zu Failed / FaceMismatch. Name und Beschreibung einer Gruppe können nach der Erstellung über die Operation zum Aktualisieren der Gruppe gesetzt werden.

​
Kontingent

Dein Konto hat eine maximale Asset-Anzahl (Standard 100, über alle Gruppen hinweg). Uploads über das Limit hinaus werden mit 403 abgelehnt.

​
Ein Asset in der Videogenerierung referenzieren

Sobald ein Asset Active ist, referenziere es per asset://<asset_id> im metadata.content[] der Seedance-Videoanfrage und verweise im Prompt per Typ + Position ([Image 1], [Video 1], [Audio 1]) darauf — niemals über die rohe 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" } }
    ]
  }
}

​
Nächstes

  • API Reference → Seedance Assets — jeder Endpunkt, vollständige Parameter und ein interaktiver Playground (hier liegen die Anfrage-/Antwort-Beispiele).
  • Seedance Video — der Videogenerierungs-Endpunkt, der diese Assets konsumiert.