TokenLab

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.

POST
/api/v3

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/json

POST /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

ActionObjectifCorps de la requête
CreateAssetGroupCréer un groupe de ressources pour avatar virtuelName ; Description optionnel ; GroupType: "AIGC" optionnel ; ProjectName
ListAssetGroupsLister les groupes dans un projetFilter.GroupIds, Filter.GroupType, Filter.Name optionnels ; PageNumber, PageSize, SortBy, SortOrder, ProjectName
GetAssetGroupLire un groupeId, ProjectName
UpdateAssetGroupModifier le nom ou la description d'un groupeId ; Name et/ou Description ; ProjectName
DeleteAssetGroupSupprimer un groupe et ses ressourcesId, 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)

ActionObjectifCorps de la requête
CreateAssetImporter une URL publique d'image, vidéo ou audioGroupId, URL, Name, AssetType, ProjectName
ListAssetsLister les ressources dans un projetFilter.GroupIds, Filter.GroupType, Filter.Statuses, Filter.Name optionnels ; PageNumber, PageSize, SortBy, SortOrder, ProjectName
GetAssetLire une ressource et son URL temporaireId, ProjectName
UpdateAssetRenommer une ressourceId ; Name optionnel ; ProjectName
DeleteAssetSupprimer une ressourceId, 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

ActionResult (champs principaux)
CreateAssetGroup, CreateAsset, UpdateAssetGroup, UpdateAsset{ "Id": "..." }
DeleteAssetGroup, DeleteAsset{}
GetAssetGroupId, Name, Description, GroupType, ProjectName, CreateTime, UpdateTime
GetAssetId, 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 :

  1. Appelez Créer une session de validation visuelle.
  2. Terminez le flux de vérification H5.
  3. Appelez Obtenir le résultat de la validation visuelle jusqu'à ce qu'il renvoie Result.GroupId.
  4. Appelez CreateAsset avec 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
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 requête

Action?string

Valeurs possibles

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
par défaut"2024-01-01"

En-têtes

X-TokenLab-Delivery-Policy?string

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