TokenLab

Vidéo & ressources

Obtenir un actif matériel

Récupère un actif matériel Seedance par son identifiant d'actif matériel TokenLab.

GET
/v1/videos/assets/{assetId}

Récupérez un actif matériel et inspectez son statut de traitement : PROCESSING, ACTIVE, FAILED ou DELETED. L'actif ne peut être utilisé pour la génération de vidéo que lorsque ready est true et que status est ACTIVE. Lorsque le traitement échoue, error_message indique la raison.

Si la génération de vidéo renvoie Seedance material asset not found or not accessible, vérifiez que vous avez transmis cet id d'actif matériel et non le group_id du matériel.

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/asset-20260720123456-qn7wr?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

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": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"
{  "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": "ACTIVE",  "ready": true,  "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

Paramètres de chemin

assetId*string

Paramètres de requête

project_name?string

Portée du projet pour la ressource matérielle.

Longueur1 <= length <= 128
par défaut"default"

Réponse

application/json

application/json

application/json

application/json

application/json