Actions de ressources (compatibles Volcengine)

Ces endpoints prennent en charge les Actions et champs de ressources ci-dessous, avec l’authentification Bearer TokenLab et l’enveloppe ResponseMetadata + Result.

Point de terminaison et authentificationCopy Anchor Link

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 de ressources acceptent uniquement POST. Une requête avec seulement une signature AK/SK renvoie 401 InvalidCredential.

ProjectName vaut default par défaut et constitue une vraie frontière d’isolation dans l’organisation authentifiée. Utilisez la même valeur pour les requêtes liées.

Actions de groupe de ressourcesCopy Anchor Link

CreateAssetGroup crée uniquement des groupes AIGC. Un groupe LivenessFace est créé après une vérification réussie ; ListAssetGroups peut filtrer les deux types.

Créer un groupeCopy Anchor Link

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 de ressourceCopy Anchor Link

AssetType accepte Image, Video et Audio. Le groupe cible détermine s’il s’agit d’une ressource AIGC classique ou LivenessFace vérifiée.

Utilisez les ID 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 aussi SortBy: "GroupId".

Créer une ressourceCopy Anchor Link

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

Comportement des listesCopy Anchor Link

PageNumber vaut 1 par défaut ; PageSize vaut 10 et accepte jusqu’à 100. SortBy accepte CreateTime ou UpdateTime, et SortOrder accepte Desc ou Asc.

Les états sont Active, Processing et Failed. Les URL temporaires de GetAsset et ListAssets sont valables 12 heures. Conservez Id comme identité permanente.

ListAssetGroups et ListAssets renvoient les ressources dans Result.Items, avec TotalCount, PageNumber et PageSize.

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Items":[],"TotalCount":0,"PageNumber":1,"PageSize":10}
}

Ressources de personnes réellesCopy Anchor Link

Créez une session de vérification visuelle, terminez la vérification H5, récupérez le GroupId, puis appelez CreateAsset avec ce groupe. Les imports sont comparés au visage vérifié.

1. Créer une session de vérification visuelle
2. Obtenir le résultat de la vérification visuelle
3. Appeler CreateAsset avec le GroupId renvoyé

ErreursCopy Anchor Link

Les erreurs conservent l’enveloppe Volcengine ; le code et le message se trouvent dans ResponseMetadata.Error.

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {"Code":"InvalidParameter","Message":"GroupId is required"}
  }
}

InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, OperationDenied, MethodNotAllowed, InternalError.

Alternative RESTCopy Anchor Link

Les endpoints REST /v1/videos/assets* restent disponibles. Les nouvelles intégrations peuvent choisir REST en snake_case ; les clients Volcengine existants n’ont pas à reformater leurs corps. Ressources Seedance et vérification des personnes.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}