Video & Materialien

Material-Asset erstellen

Lädt ein Seedance-Material-Asset in eine TokenLab-Materialgruppe hoch.

POST
/v1/videos/assets

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; ohne diese Angabe verwendet oder erstellt TokenLab die Standard-Virtual-Avatar-Gruppe 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. group_id ist ebenfalls erforderlich, wenn project_name nicht default ist. Die Gruppe muss zum selben project_name und library_type gehören, andernfalls gibt die Anfrage 400 zurück.

TypUnterstützte Eingabe
Bildjpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; Breite und Höhe [300, 6000] px; Seitenverhältnis [0.4, 2.5].
Videomp4, mov; ≤200 MiB.
Audioaac, wav, mp3; ≤15 MiB.

TokenLab überprüft die Quell-URL, den Medientyp, die Dateigröße und, sofern das Bild gelesen werden kann, dessen Abmessungen, bevor die Anfrage akzeptiert wird. Eine Quelle, die diese Prüfungen nicht besteht, gibt 400 mit einem seedance_material_source_*-Code zurück, zum Beispiel seedance_material_source_invalid (Bildabmessungen oder Seitenverhältnis außerhalb des Bereichs), seedance_material_source_type_mismatch, seedance_material_source_too_large oder seedance_material_source_url_unreachable. Andere Medien- und Gesichtsanforderungen werden während der Verarbeitung bewertet, daher bedeutet die Annahme nicht, dass das Asset bereit ist: Warten Sie auf ACTIVE und überprüfen Sie error_message, falls die Verarbeitung fehlschlägt.

Eine erfolgreiche Anfrage gibt 201 mit status: "PROCESSING" zurück. Pollen Sie Material-Asset abrufen, 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 grenzt Ressourcen innerhalb Ihrer Organisation ab und ist standardmäßig auf default gesetzt. Verwenden Sie denselben, zwischen Groß- und Kleinschreibung unterscheidenden Wert für zugehörige Gruppen und Assets. Senden Sie ihn im JSON-Body für POST/PUT und im Query-String für GET/DELETE.

Beispielanfrage

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-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'

Beispielantwort

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view",
  "asset_type": "Image",
  "status": "PROCESSING",
  "ready": false,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_url": "https://example.com/reference.png",    "asset_name": "Front view",    "asset_type": "Image",    "library_type": "aigc_avatar",    "group_id": "group-20260720123456-vrt01"  }'
{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view",  "asset_type": "Image",  "status": "PROCESSING",  "ready": false,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json

application/json