TokenLab

Vidéo & ressources

Créer un actif matériel

Télécharge un actif matériel Seedance dans un groupe matériel TokenLab.

POST
/v1/videos/assets

Importez une URL source accessible publiquement dans un groupe matériel Seedance. TokenLab stocke le matériel pour une utilisation ultérieure ; utilisez l' id de l'actif matériel renvoyé pour la génération, et non l'URL source.

Pour library_type: "aigc_avatar", group_id est facultatif ; sans celui-ci, TokenLab utilise ou crée le groupe d'avatars virtuels par défaut de l'organisation. Pour library_type: "liveness_face", group_id est obligatoire et doit correspondre au groupe TokenLab renvoyé par Obtenir le résultat de la validation visuelle. group_id est également requis lorsque project_name n'est pas default. Le groupe doit appartenir au même project_name et au même library_type, sinon la requête renverra 400.

TypeEntrée prise en charge
Imagejpeg, jpg, png, webp, bmp, tiff, gif, heic, heif ; ≤30 MiB ; largeur et hauteur [300, 6000] px ; rapport hauteur/largeur [0.4, 2.5].
Vidéomp4, mov ; ≤200 MiB.
Audioaac, wav, mp3 ; ≤15 MiB.

TokenLab vérifie l'URL source, le type de média, la taille du fichier et, lorsque l'image peut être lue, ses dimensions avant d'accepter la requête. Une source qui échoue à ces vérifications renvoie 400 avec un code seedance_material_source_*, par exemple seedance_material_source_invalid (dimensions d'image ou rapport hauteur/largeur hors plage), seedance_material_source_type_mismatch, seedance_material_source_too_large ou seedance_material_source_url_unreachable. Les autres exigences relatives aux médias et aux visages sont évaluées lors du traitement ; l'acceptation ne signifie donc pas que l'actif est prêt : attendez l'état ACTIVE et inspectez error_message si le traitement échoue.

Une requête réussie renvoie 201 avec status: "PROCESSING". Interrogez Obtenir un actif matériel jusqu'à ce que status soit ACTIVE. Pour les groupes de personnes réelles, un groupe correspond à une personne vérifiée ; les téléchargements contenant plusieurs visages ou un visage qui ne correspond pas à la personne vérifiée peuvent échouer.

project_name délimite les ressources au sein de votre organisation et est défini par défaut sur default. Utilisez la même valeur sensible à la casse pour les groupes et les actifs associés. Envoyez-le dans le corps JSON pour les requêtes POST/PUT et dans la chaîne de requête pour les requêtes GET/DELETE.

Exemple de requête

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"}'

Exemple de réponse

{
  "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}

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Corps de la requête

application/json

Réponse

application/json

application/json

application/json

application/json

application/json

application/json