Seedance-Materialien und Personenverifizierung

Seedance-Materialien sind innerhalb einer Organisation wiederverwendbare Bild-, Video- oder Audioreferenzen. Wählen Sie zuerst den Workflow: Normale Avatar-Materialien und verifizierte Personenmaterialien haben unterschiedliche Erstellungspfade.

Material-Workflow wählenCopy Anchor Link

MaterialkonzepteCopy Anchor Link

Seedance-Materialien sind wiederverwendbare, organisationsbezogene Referenzen, die später während der Videogenerierung ausgewählt werden können.

Halten Sie group_id und Material-Asset id getrennt. group_id dient der Organisation von Uploads; die Material-Asset id dient der Videogenerierung. Wenn eine Videoanfrage Seedance material asset not found or not accessible zurückgibt, stellen Sie sicher, dass Sie eine Material-Asset id und keine group_id übergeben haben und dass das Asset zur selben Organisation gehört, nicht gelöscht wurde und den status: "ACTIVE" aufweist.

Aufbewahrung von MaterialienCopy Anchor Link

TokenLab behält jedes Material-Asset, bis Sie das Asset oder seine Gruppe löschen. Auf Seiten von TokenLab wird es nicht wegen Inaktivität bereinigt.

Der Upstream-Anbieter Seedance kann seine eigene Arbeitskopie eines Assets nach 30 Tagen ohne Nutzung entfernen. Dadurch wird Ihr Asset weder gelöscht noch ändert sich seine ID: Bei der nächsten Verwendung in einer Generierungsanfrage erstellt TokenLab automatisch eine neue Upstream-Kopie aus dem gespeicherten Original.

• Die erste Generierung nach einer Bereinigung kann etwas länger dauern, während die neue Kopie vorbereitet wird. Ist sie noch nicht bereit, gibt die Anfrage seedance_material_preparing zurück; versuchen Sie es in Kürze erneut.
• Das Löschen eines Assets oder einer Gruppe ist endgültig und kann nicht rückgängig gemacht werden.

Bild-URLs und wiederverwendbare MaterialienCopy Anchor Link

Übergeben Sie öffentliche HTTP(S)-URLs oder unterstützte data-URLs in den Bildfeldern des gewählten Modells. Sie werden als normale Medieneingaben verarbeitet und erzeugen nicht automatisch wiederverwendbare Material-IDs.

Für wiederverwendbare Materialien erstellen Sie ein Asset über die Material-API, warten auf ACTIVE und verwenden dann material_asset_id, material_asset_ids oder asset://<id> in einem unterstützten Medienfeld. Behalten Sie die Rolle als Anfangsbild, Endbild oder Referenzbild bei.

Ist ein ausdrücklich angegebenes Material noch in Vorbereitung, liefert POST /v1/videos/generations den Fehler 409 seedance_material_preparing mit inactive_asset_ids. Fragen Sie diese Assets bis ACTIVE ab und wiederholen Sie die Anfrage mit denselben IDs. Bei FAILED prüfen Sie zunächst error_message und korrigieren oder importieren das Asset erneut.

Verifizierung von Material echter PersonenCopy Anchor Link

Verwenden Sie die Verifizierung von Material echter Personen, wenn Ihr Produkt eine Zustimmung und Gesichtsverifizierung erfordert, bevor eine echte Person als wiederverwendbare Seedance-Referenz genutzt werden kann.

1. Rufen Sie Visuelle Verifizierungssitzung erstellen mit CallbackURL auf und speichern Sie den zurückgegebenen Result.BytedToken.
2. Öffnen Sie Result.H5Link für die zu verifizierende Person. Hängen Sie für eine bestimmte Sprache lng an den H5-Link an.
3. Nach Abschluss des H5-Ablaufs öffnet der Browser Result.CallbackURL mit offiziellen Abfragenamen wie bytedToken und resultCode.
4. Rufen Sie Visuelles Verifizierungsergebnis abrufen wiederholt mit BytedToken auf, bis Result.GroupId zurückgegeben wird.
5. Speichern Sie GroupId und verwenden Sie sie beim Erstellen von liveness_face-Materialien als group_id.

BytedToken ist 30 Minuten gültig. Verwenden Sie in beiden Action-Anfragen denselben ProjectName. Die Authentifizierung erfolgt mit Authorization: Bearer <TOKENLAB_API_KEY>; Volc-AK/SK-Signaturen werden nicht akzeptiert.

Öffnen Sie den zurückgegebenen H5Link direkt nach der Erstellung. Die Token-Gültigkeit garantiert nicht, dass die Prüfseite zu jedem Zeitpunkt dieses Zeitraums erstmals geöffnet werden kann.

Optional: Verwenden Sie die Testkonsole, um Ihren Anfrage- und Callback-Ablauf zu verifizieren, Materialgruppen zu untersuchen und den Verifizierungsverlauf einzusehen. Ihre Produktionsintegration sollte die APIs direkt aufrufen.

Erstellen von MaterialgruppenCopy Anchor Link

Verwenden Sie Material-Asset-Gruppe erstellen für aigc_avatar-Gruppen. Neue Gruppen für echte Personen werden über den Verifizierungsprozess erstellt, damit die verifizierte Person und die Materialgruppe verknüpft bleiben.

Verwenden Sie Material-Asset-Gruppen auflisten, Material-Asset-Gruppe abrufen, Material-Asset-Gruppe aktualisieren und Material-Asset-Gruppe löschen, um Gruppen zu verwalten, nachdem sie erstellt wurden.

Das Löschen einer Materialgruppe löscht auch die darin enthaltenen TokenLab-Materialien und kann nicht rückgängig gemacht werden. Wenn die TokenLab-Materialbibliothek den Löschvorgang nicht abschließen kann, weil der aktuelle Autorisierungsstatus dies nicht zulässt, gibt TokenLab einen neutralen Materialbibliotheksfehler zurück.

Hochladen von MaterialienCopy Anchor Link

Verwenden Sie Material-Asset erstellen, um jeweils eine öffentlich erreichbare Quell-URL zu importieren.

Für aigc_avatar ist die group_id optional; TokenLab verwendet oder erstellt die standardmäßige virtuelle Avatar-Gruppe der Organisation. Für liveness_face ist die group_id erforderlich und muss die Gruppe sein, die von Visuelles Verifizierungsergebnis abrufen zurückgegeben wurde.

Die Tabelle zeigt Importgrenzen. Eine angenommene Anfrage garantiert nicht die erfolgreiche Medien- oder Personenprüfung. Warten Sie auf ACTIVE; bei FAILED korrigieren Sie die Quelle anhand von error_message vor einem neuen Import.

Die Materialaufnahme erfolgt asynchron. Pollen Sie Material-Asset abrufen, bis der status auf ACTIVE wechselt. Eine erfolgreiche HTTP-Antwort bedeutet lediglich, dass die Anfrage akzeptiert wurde; lesen Sie immer den Geschäftsstatus. Wenn der Status FAILED lautet, untersuchen Sie die error_message, korrigieren Sie das Quellmaterial und erstellen Sie ein neues Asset.

In Anfragen zum Erstellen von Materialien ist asset_url nur die Importquelle. TokenLab gibt eine Material-Asset-id zurück; verwenden Sie diese id für die Generierung statt der ursprünglichen URL.

TokenLab behält Material-Assets in Ihrer Organisationsbibliothek, bis Sie das Asset oder seine Materialgruppe löschen. Die Upstream-Kopie wird nach einer Bereinigung automatisch neu erstellt; siehe den Abschnitt zur Aufbewahrung oben.

Bei Materialgruppen für echte Personen entspricht eine Gruppe einer echten Person. Uploads werden mit dem verifizierten Gesicht abgeglichen. Assets mit mehreren Gesichtern oder einem Gesicht, das nicht mit der verifizierten Person übereinstimmt, können fehlschlagen. Für beste Ergebnisse laden Sie sowohl ein Ganzkörper-Referenzbild von vorne als auch eine Nahaufnahme von vorne hoch, auf der das Gesicht klar erkennbar ist.

Verwendung von Materialien bei der VideogenerierungCopy Anchor Link

Nachdem ein Asset ACTIVE ist, übergeben Sie die zurückgegebene TokenLab-Asset id als material_asset_id oder fügen Sie sie in material_asset_ids ein, wenn Sie Video erstellen aufrufen. Material-Assets zählen gegen die Seedance-Referenzlimits.

REST oder Volcengine ActionCopy Anchor Link

TokenLab-native Integrationen können weiterhin die snake_case-REST-API /v1/videos/assets* verwenden. Bestehende Volcengine-Clients behalten PascalCase-Bodies und verwenden die Volcengine-kompatiblen Material-Actions. Beide Varianten bearbeiten dieselben organisations- und projektgebundenen Materialdaten.

API-BeispieleCopy Anchor Link

Erstellen Sie eine virtuelle Avatar-Gruppe, laden Sie ein Bild hoch, pollen Sie, bis es aktiv ist, und verwenden Sie dann die Material-Asset-ID in einer Videoanfrage.

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references"}'

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-abc12","asset_url":"https://example.com/reference.png","asset_type":"Image"}'

curl https://api.tokenlab.sh/v1/videos/assets/asset-20260720123457-def45 \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Erstellen Sie für eine Materialgruppe einer echten Person zuerst eine visuelle Verifizierungssitzung und rufen Sie das Ergebnis ab, bevor Sie Materialien hochladen.

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

Vollständiger Action-Ablauf für reale PersonenCopy Anchor Link

Übergeben Sie die vom Verifizierungsergebnis gelieferte GroupId an CreateAsset.

curl 'https://api.tokenlab.sh/?Action=CreateAsset&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "GroupId":"group-20260720123456-real1",
    "URL":"https://example.com/person-front.png",
    "Name":"Verified front view",
    "AssetType":"Image",
    "ProjectName":"default"
  }'

Pollen Sie GetAsset, bis der Status Active ist, und verwenden Sie dann die zurückgegebene Material-ID in der Videogenerierung.