Vidéo & ressources
Actions sur les ressources (compatibles Volc)
Référence pour les 10 Actions sur les ressources et groupes de ressources compatibles avec Volcengine.
Ces endpoints prennent en charge les Actions et champs sur les ressources listés ci-dessous, en utilisant l'authentification Bearer de TokenLab et l'enveloppe ResponseMetadata + Result.
Endpoint et authentification
POST https://api.tokenlab.sh/?Action=<ACTION>&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonPOST /api/v3?Action=<ACTION>&Version=2024-01-01 est également pris en charge. Toutes les Actions sur les ressources sont uniquement en POST. Les signatures AK/SK de Volcengine ne sont pas acceptées ; une requête sans clé Bearer TokenLab valide renvoie 401 InvalidCredential.
ProjectName est défini par défaut sur default et constitue une véritable limite d'isolation au sein de l'organisation authentifiée. Utilisez la même valeur lors de la création, de la liste, de la lecture, de la mise à jour ou de la suppression de groupes et d'actifs associés.
Actions sur les groupes de ressources
| Action | Objectif | Corps de la requête |
|---|---|---|
CreateAssetGroup | Créer un groupe de ressources pour avatar virtuel | Name ; Description optionnel ; GroupType: "AIGC" optionnel ; ProjectName |
ListAssetGroups | Lister les groupes dans un projet | Filter.GroupIds, Filter.GroupType, Filter.Name optionnels ; PageNumber, PageSize, SortBy, SortOrder, ProjectName |
GetAssetGroup | Lire un groupe | Id, ProjectName |
UpdateAssetGroup | Modifier le nom ou la description d'un groupe | Id ; Name et/ou Description ; ProjectName |
DeleteAssetGroup | Supprimer un groupe et ses ressources | Id, ProjectName |
CreateAssetGroup n'accepte que GroupType: "AIGC". Un groupe LivenessFace est créé suite à une vérification réussie d'une personne réelle, et non par cette Action. ListAssetGroups peut filtrer à la fois les groupes AIGC et LivenessFace. Name fait entre 1 et 64 caractères et Description jusqu'à 300, ce qui est plus court que les limites des endpoints REST /v1/videos/assets*.
Créer un groupe
curl 'https://api.tokenlab.sh/?Action=CreateAssetGroup&Version=2024-01-01' \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name":"Product references",
"Description":"Reusable product shots",
"GroupType":"AIGC",
"ProjectName":"default"
}'{
"ResponseMetadata": {
"RequestId": "req-id",
"Action": "CreateAssetGroup",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": { "Id": "group-20260720123456-abc12" }
}Actions sur les ressources (Assets)
| Action | Objectif | Corps de la requête |
|---|---|---|
CreateAsset | Importer une URL publique d'image, vidéo ou audio | GroupId, URL, Name, AssetType, ProjectName |
ListAssets | Lister les ressources dans un projet | Filter.GroupIds, Filter.GroupType, Filter.Statuses, Filter.Name optionnels ; PageNumber, PageSize, SortBy, SortOrder, ProjectName |
GetAsset | Lire une ressource et son URL temporaire | Id, ProjectName |
UpdateAsset | Renommer une ressource | Id ; Name optionnel ; ProjectName |
DeleteAsset | Supprimer une ressource | Id, ProjectName |
AssetType accepte Image, Video ou Audio. Le groupe cible détermine si la ressource est un matériel AIGC standard ou un matériel LivenessFace vérifié.
Créer une ressource
curl 'https://api.tokenlab.sh/?Action=CreateAsset&Version=2024-01-01' \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"GroupId":"group-20260720123456-abc12",
"URL":"https://example.com/reference.png",
"Name":"Front view",
"AssetType":"Image",
"ProjectName":"default"
}'Utilisez les IDs de ressources TokenLab. CreateAsset renvoie Result.Id avant la fin du traitement ; interrogez GetAsset jusqu'à ce que Result.Status soit Active ou Failed. ListAssets accepte également SortBy: "GroupId".
Comportement de liste
PageNumber est défini par défaut sur 1 ; PageSize est défini par défaut sur 10 et accepte jusqu'à 100. SortBy accepte CreateTime ou UpdateTime ; SortOrder accepte Desc ou Asc.
Les réponses de liste renvoient :
{
"ResponseMetadata": {
"RequestId": "req-id",
"Action": "ListAssets",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Items": [],
"TotalCount": 0,
"PageNumber": 1,
"PageSize": 10
}
}Les valeurs de statut des ressources sont Active, Processing et Failed. GetAsset et ListAssets renvoient une URL temporaire valide pendant 12 heures ; ne la stockez pas comme identité permanente de la ressource. Stockez plutôt l'Id.
Résultats
| Action | Result (champs principaux) |
|---|---|
CreateAssetGroup, CreateAsset, UpdateAssetGroup, UpdateAsset | { "Id": "..." } |
DeleteAssetGroup, DeleteAsset | {} |
GetAssetGroup | Id, Name, Description, GroupType, ProjectName, CreateTime, UpdateTime |
GetAsset | Id, GroupId, Name, AssetType, URL, Status, Error (Code et Message, vide sauf si la ressource a échoué), ProjectName, CreateTime, UpdateTime |
Les heures sont des chaînes au format ISO 8601. ListAssetGroups et ListAssets renvoient ces objets dans Result.Items.
Ressources pour personnes réelles
Avant d'importer une ressource pour une personne réelle :
- Appelez Créer une session de validation visuelle.
- Terminez le flux de vérification H5.
- Appelez Obtenir le résultat de la validation visuelle jusqu'à ce qu'il renvoie
Result.GroupId. - Appelez
CreateAssetavec cet ID de groupe vérifié.
Les téléchargements vers un groupe LivenessFace sont vérifiés par rapport au visage validé. DeleteAssetGroup ne supprime pas un groupe de personne réelle vérifié ; il renvoie 409 OperationDenied.
Erreurs
Les erreurs conservent l'enveloppe de réponse Volcengine et placent le code et le message sous ResponseMetadata.Error.
{
"ResponseMetadata": {
"RequestId": "req-id",
"Action": "CreateAsset",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing",
"Error": {
"Code": "InvalidParameter",
"Message": "GroupId is required"
}
}
}Les codes courants incluent InvalidCredential, InvalidVersion, InvalidParameter, ResourceNotFound, Conflict, OperationDenied, MethodNotAllowed, AccessDenied, FlowLimitExceeded et InternalError. Le statut HTTP est 400 pour les mauvaises requêtes, 404 pour un groupe ou une ressource manquante, 409 pour les conflits et 405 pour une méthode autre que POST.
Alternative REST
Les endpoints REST /v1/videos/assets* de TokenLab restent disponibles. Les nouvelles intégrations natives TokenLab peuvent préférer leurs corps en snake_case ; les clients Volcengine existants peuvent utiliser les Actions sur cette page sans reformater les requêtes. Voir Ressources Seedance et vérification des personnes pour le cycle de vie complet des ressources.
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de requête
Valeurs possibles
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"En-têtes
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json