Vidéo & ressources
Créer un actif matériel
Télécharge un actif matériel Seedance dans un groupe matériel TokenLab.
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.
| Type | Entrée prise en charge |
|---|---|
| Image | jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif ; ≤30 MiB ; largeur et hauteur [300, 6000] px ; rapport hauteur/largeur [0.4, 2.5]. |
| Vidéo | mp4, mov ; ≤200 MiB. |
| Audio | aac, 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 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