Skip to main content
POST
Importieren Sie eine öffentlich erreichbare Quell-URL in eine Seedance-Materialgruppe. TokenLab speichert das Material für die spätere Verwendung; verwenden Sie für die Generierung die zurückgegebene Material-Asset-id und nicht die Quell-URL. Für library_type: "aigc_avatar" ist group_id optional; TokenLab verwendet oder erstellt die Standard-Gruppe für virtuelle Avatare der Organisation. Für library_type: "liveness_face" ist group_id erforderlich und muss die TokenLab-Gruppe sein, die von Visuelles Verifizierungsergebnis abrufen zurückgegeben wurde. TokenLab prüft Quell-URL, Medientyp, Dateigröße und lesbare Bildabmessungen. Ein angenommener Import bedeutet noch keine Verfügbarkeit: Warten Sie auf ACTIVE und prüfen Sie bei einem Verarbeitungsfehler error_message. Weitere Medien- und Gesichtsanforderungen werden während der Verarbeitung geprüft. Die Erstellung erfolgt asynchron. Fragen Sie Material-Asset abrufen ab, bis der status auf ACTIVE steht. Bei Gruppen für echte Personen wird eine Gruppe einer verifizierten Person zugeordnet; Uploads mit mehreren Gesichtern oder einem Gesicht, das nicht mit der verifizierten Person übereinstimmt, können fehlschlagen. project_name trennt Ressourcen innerhalb der authentifizierten Organisation. Der Standard ist default; verwenden Sie für zugehörige Gruppen und Assets denselben Wert mit gleicher Groß- und Kleinschreibung. Senden Sie ihn bei POST/PUT im JSON-Body und bei GET/DELETE als Query-Parameter.

Beispielanfrage

Beispielantwort

Autorisierungen

Authorization
string
header
erforderlich

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Body

application/json
asset_url
string<uri>
erforderlich

Öffentlich erreichbare Quell-URL für den Import. TokenLab speichert das Material zur späteren Verwendung; verlassen Sie sich nicht auf diese URL als langfristige Materialadresse.

asset_name
string

Optionaler Anzeigename, der mit dem Material-Asset gespeichert wird.

Required string length: 1 - 128
asset_type
enum<string>
Standard:Image
Verfügbare Optionen:
Image,
Video,
Audio
library_type
enum<string>
Standard:aigc_avatar

Material-Bibliotheksklasse. aigc_avatar ist für virtuelle Avatar-Materialien. liveness_face ist für verifizierte Materialien echter Personen.

Verfügbare Optionen:
aigc_avatar,
liveness_face
group_id
string

TokenLab Materialgruppen-ID. Erforderlich für liveness_face-Materialien; optional für aigc_avatar.

project_name
string
Standard:default

Projektbereich für das Material-Asset. Assets und Gruppen sind innerhalb der authentifizierten Organisation nach Projekt isoliert.

Required string length: 1 - 128
metadata
object | null

Optionale Client-Metadaten, die mit dem Material-Asset gespeichert werden.

Antwort

Material-Asset erstellt

id
string
erforderlich

TokenLab Material-Asset-ID. Verwenden Sie diese als material_asset_id, nachdem das Asset den Status ACTIVE erreicht hat.

object
enum<string>
erforderlich
Verfügbare Optionen:
seedance.material_asset
library_type
enum<string>
erforderlich
Verfügbare Optionen:
aigc_avatar,
liveness_face
asset_type
enum<string>
erforderlich
Verfügbare Optionen:
Image,
Video,
Audio
status
enum<string>
erforderlich
Verfügbare Optionen:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
erforderlich

True, wenn das Asset aktiv und nicht gelöscht ist.

group_id
string | null

TokenLab Materialgruppen-ID, zu der dieses Material-Asset gehört.

project_name
string

Projektbereich für dieses Material-Asset.

asset_name
string | null
error_message
string | null

Öffentlich sicherer terminaler Verarbeitungsfehler. Permanente Quellvalidierungsfehler beinhalten die abgelehnte Dimensionsbeschränkung.

metadata
object | null
created_at
integer

Unix-Zeitstempel, zu dem der Material-Asset-Datensatz erstellt wurde.

updated_at
integer

Unix-Zeitstempel, zu dem der Material-Asset-Datensatz zuletzt aktualisiert wurde.