Kann ich ein Gesichtsbild hochladen und in Seedance wiederverwenden?

Ja. Sie können ein Gesichts- oder Personenfoto als private asset hochladen und in Seedance-Videogenerierung verwenden. Es ist referenzgeführte Generierung, kein garantiertes Face Swap.

Ist Seedance Private Asset Library dasselbe wie Face Swap?

Nein. Die Bibliothek nutzt hochgeladene Assets als wiederverwendbare Generierungsreferenzen. Ziel ist Charakter- oder Motivkonsistenz, nicht exakter Gesichtsaustausch.

Kann ich ein Personen-Asset mit einem Landschaftsbild kombinieren?

Ja. Häufig steht das Personen-Asset zuerst in image_urls und die Landschafts-URL an zweiter Stelle. Im Prompt beschreiben Sie dann Image 1 und Image 2.

Welche Seedance API Task-Typen unterstützen private assets?

Private assets funktionieren mit seedance-2-less-restriction und seedance-2-fast-less-restriction. seedance-2 und seedance-2-fast unterstützen asset:// nicht.

Was ist der Unterschied zwischen private assets und Auto-Upload?

Private assets sind verwaltete Referenzen, die einmal hochgeladen und wiederverwendet werden. Auto-Upload importiert rohe URLs temporär für einmalige Aufgaben mit auto_upload_assets: true.

Kann ich private assets im Playground testen?

Private assets sind vor allem ein API- und Backend-Workflow. Wenn der Playground Upload, Status, asset:// und less-restriction Task-Typen nicht anbietet, testen Sie mit cURL, Postman oder Backend-Code.

So verwenden Sie Seedance Private Assets mit der Seedance API

Q: Was ist ein Seedance private asset?

Ein Seedance private asset ist eine wiederverwendbare Referenz, die zu PiAPI für Seedance-Videogenerierung hochgeladen wird. Sobald sie Active ist, können Sie sie mit asset:// in späteren Aufgaben referenzieren.

PiAPI unterstützt jetzt die Seedance Private Asset Library, einen Seedance API-Workflow zum Hochladen wiederverwendbarer Referenzen, die später mit asset://<asset_id> aufgerufen werden können.

Die Seedance Private Asset Library eignet sich für Gesichter, Figuren, Produkte, Szenen, Videos oder Audiodateien, die in mehreren Seedance API-Aufgaben wiederverwendet werden sollen. Sie ist für Referenz-Workflows und Charakterkonsistenz gedacht, nicht für klassisches Face Swap, Inpainting oder pixelgenaue Bildbearbeitung.

Wichtigste Punkte

Verwenden Sie private assets, wenn ein Gesicht, eine Figur, ein Produkt oder ein anderes Motiv in mehreren zukünftigen Videos erscheinen soll.
Verwenden Sie rohe URLs für einmalige Hintergründe, Requisiten oder Referenzbilder.
Verwenden Sie auto_upload_assets: true, wenn eine einmalige Nutzerreferenz temporär importiert werden soll.
Private assets müssen Active sein, bevor sie in einer Seedance-Aufgabe referenziert werden.
asset:// funktioniert mit seedance-2-less-restriction und seedance-2-fast-less-restriction, nicht mit den strikten Seedance-Task-Typen.

Kurzantwort

Seedance private assets sind für wiederverwendbare Referenzen in der Seedance API gedacht. Laden Sie die Referenz einmal hoch, warten Sie auf Active, und verwenden Sie sie in späteren Videoaufgaben mit asset://<asset_id>.

Was sind Seedance Private Assets?

Seedance private assets sind wiederverwendbare Dateien, die Ihre Anwendung vor der Videogenerierung zu PiAPI hochlädt. Nach dem Upload gibt PiAPI eine asset_id zurück. Sobald das Asset Active ist, kann Ihre Seedance API-Anfrage es in diesem Format verwenden. Details zu Endpoints, Quotas und Lebenszyklus finden Sie in den Private Asset Library Docs.

asset://<asset_id>

Statt dasselbe Gesichtsbild, Charakterbild, Produktfoto, Video oder Audio immer wieder zu senden, laden Sie es einmal hoch und nutzen die Asset-ID in mehreren Aufgaben.

Ein private asset ist eine wiederverwendbare Referenz für Seedance-Videogenerierung.

Welches Problem lösen private assets?

KI-Videogenerierung wird schwierig, wenn derselbe Gegenstand über mehrere Prompts, Szenen oder kreative Varianten hinweg konsistent bleiben soll. Eine rohe Bild-URL kann für eine einzelne Aufgabe helfen, ist aber für wiederholte Nutzung unpraktisch.

Typische Anwendungsfälle sind konsistente Personen oder Figuren, Avatar- und Creator-Produkte, wiederverwendete Produktreferenzen für Anzeigenvarianten, stabile Besetzung in Kurzfilmen, feste Motive mit wechselnden Hintergründen und weniger wiederholte Uploads im Backend.

Für einen Modellüberblick lesen Sie zuerst den Seedance 2.0 API Guide.

Was private assets nicht sind

Die Seedance Private Asset Library ist kein klassisches Face Swap, kein Inpainting und keine exakte Fotomontage. Wenn Sie ein Personenfoto und ein Landschaftsbild hochladen, nutzt Seedance beide als Generierungsreferenzen. Das Ergebnis ist referenzgeführtes Video, nicht pixelgenaues Compositing.

Private Assets vs rohe URLs vs Auto-Upload

Muster	Am besten für	Beispieleingabe	Wann verwenden
Managed private asset	Wiederkehrende Personen, Figuren, Produkte oder Motive	`asset://asset-123`	Wenn dieselbe Referenz in mehreren zukünftigen Aufgaben erscheint.
Raw URL	Einmalige Szene, Hintergrund oder Requisite	`https://your-cdn.com/scene.jpg`	Wenn die Referenz nur für die aktuelle Aufgabe wichtig ist.
Auto-uploaded ephemeral asset	Temporäre Nutzerreferenzen	URL + `auto_upload_assets: true`	Wenn PiAPI eine Referenz nur kurz importieren soll.
Managed cast + raw scenery	Stabiles Motiv mit wechselnden Hintergründen	`asset://person`, `https://.../scene.jpg`	Wenn das Motiv wiederkehrt, der Hintergrund aber nicht.

Einfache Regel: Wird eine Referenz später wiederverwendet, machen Sie sie zu einem private asset. Wird sie nur einmal benötigt, verwenden Sie eine rohe URL oder Auto-Upload.

So funktioniert der Workflow

Wiederverwendbare Referenz hochladen.
Warten, bis der Status Active ist.
Eine Seedance-Aufgabe mit asset://<asset_id> in image_urls, video_urls oder audio_urls senden.
Eingaben im Prompt als Image 1, Image 2, Video 1 oder Audio 1 bezeichnen.
Die Seedance-Aufgabe abfragen, bis das Video fertig ist.

Die Reihenfolge ist wichtig. Wenn das private asset zuerst in image_urls steht und die Landschaft an zweiter Stelle, bedeutet Image 1 das Asset und Image 2 den Hintergrund.

{
  "image_urls": [
    "asset://asset-20260607154123-aaaa1",
    "https://your-cdn.com/scenic-background.jpg"
  ]
}

Im Prompt können Sie schreiben:

Image 1 is the person reference. Image 2 is the scenic background.

Beispiel: Personen-Asset mit Landschaft

Sie können ein Personenfoto als private asset hochladen, die Landschaft als rohe URL übergeben und Seedance bitten, ein Video aus beiden Referenzen zu erzeugen. Das Resultat ist generiertes Video, keine exakte Fotomontage.

{
  "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 of the person from Image 1 standing naturally in the location from Image 2."
}

API-Beispiel

Schritt 1: Private asset hochladen

Die Quell-URL muss öffentlich erreichbar bleiben, während PiAPI die Datei abruft und verarbeitet. Mindestens 24 Stunden Verfügbarkeit ist die sicherste Vorgabe.

curl --request POST "https://api.piapi.ai/api/v1/asset/upload"
  --header "X-API-Key: $PIAPI_API_KEY"
  --header "Content-Type: application/json"
  --data '{"url":"https://your-cdn.com/person-reference.jpg","asset_type":"Image","name":"main-character"}'

Schritt 2: Asset-Status prüfen

curl --request GET "https://api.piapi.ai/api/v1/asset/list?status=active,processing,failed"
  --header "X-API-Key: $PIAPI_API_KEY"

Ist das Asset noch Processing, warten Sie und prüfen erneut. Bei Failed prüfen Sie die Fehlermeldung und laden eine korrigierte Datei hoch.

Schritt 3: Seedance-Aufgabe mit `asset://` senden

Verwenden Sie seedance-2-less-restriction oder seedance-2-fast-less-restriction. Strikte Varianten wie seedance-2 und seedance-2-fast unterstützen keine asset://-Referenzen.

Auto-Upload für einmalige Referenzen

Wenn eine Referenz nur für eine Aufgabe gebraucht wird, nutzen Sie auto_upload_assets: true. PiAPI kann Nicht-asset://-URLs temporär importieren, für die Aufgabe verwenden und nach dem Retention-Fenster bereinigen.

Best Practices

Nutzen Sie private assets für wiederkehrende Gesichter, Figuren, Produkte oder Markenmotive.
Lassen Sie einmalige Hintergründe als rohe URLs.
Verwenden Sie klare Prompt-Labels wie Image 1, Image 2, Video 1 oder Audio 1.
Warten Sie auf Active, bevor Sie generieren.
Planen Sie Quotas, TTL und Zustimmung für Nutzerreferenzen.

Häufige Fehler

Strikten Task-Typ verwenden

seedance-2 funktioniert nicht mit asset://. Verwenden Sie eine less-restriction-Variante.

Asset zu früh referenzieren

Richtiger Ablauf: Asset hochladen -> Status abfragen -> auf Active warten -> Seedance-Aufgabe senden.

Jeden Hintergrund als Asset hochladen

Bewahren Sie private asset Slots für Referenzen auf, die über mehrere Aufgaben hinweg konsistent bleiben müssen.

FAQ

Was ist ein Seedance private asset?

Eine wiederverwendbare Referenz, die zu PiAPI hochgeladen wird. Sobald sie Active ist, kann sie mit asset://<asset_id> verwendet werden.

Kann ich ein Gesichtsbild wiederverwenden?

Ja, als referenzgeführte Generierung. Es ist kein garantiertes Face Swap.

Ist das dasselbe wie Face Swap?

Nein. Ziel ist Motiv- oder Charakterkonsistenz in generiertem Video.

Fazit

Die Seedance Private Asset Library bietet Entwicklern einen sauberen Weg, wiederverwendbare Referenz-Workflows mit der Seedance API zu bauen. Laden Sie eine Referenz hoch, bestätigen Sie Active, und senden Sie eine seedance-2-less-restriction-Aufgabe mit Asset, Prompt und einmaligen URLs. Testen können Sie Seedance im Seedance workspace.

Quellen:

PiAPI Private Asset Library docs: https://piapi.ai/docs/seedance-api/private-asset
Seedance 2.0 arXiv page: https://arxiv.org/abs/2604.14148