Actions de materiales (compatibles con Volcengine)

Estos endpoints admiten las Actions y los campos de materiales indicados a continuación, con autenticación Bearer de TokenLab y el sobre ResponseMetadata + Result.

Endpoint y autenticaciónCopy Anchor Link

POST https://api.tokenlab.sh/?Action=<ACTION>&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

También se admite POST /api/v3?Action=<ACTION>&Version=2024-01-01. Todas las Actions de materiales son solo POST. Una solicitud con únicamente firma AK/SK devuelve 401 InvalidCredential.

ProjectName usa default por defecto y es una frontera real de aislamiento dentro de la organización autenticada. Usa el mismo valor en solicitudes relacionadas.

Actions de gruposCopy Anchor Link

CreateAssetGroup solo crea grupos AIGC. Un grupo LivenessFace se crea tras verificar correctamente a la persona; ListAssetGroups puede filtrar ambos tipos.

Crear un grupoCopy 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 materialesCopy Anchor Link

AssetType admite Image, Video y Audio. El grupo de destino determina si es un material AIGC normal o LivenessFace verificado.

Use ID de materiales de TokenLab. CreateAsset devuelve Result.Id antes de terminar el procesamiento; consulte GetAsset hasta que Result.Status sea Active o Failed. ListAssets también admite SortBy: "GroupId".

Crear un materialCopy 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"}'

Comportamiento de listasCopy Anchor Link

PageNumber usa 1 por defecto; PageSize usa 10 y admite hasta 100. SortBy admite CreateTime o UpdateTime; SortOrder admite Desc o Asc.

Los estados son Active, Processing y Failed. Las URL temporales de GetAsset y ListAssets duran 12 horas. Guarda Id como identidad permanente.

ListAssetGroups y ListAssets devuelven recursos en Result.Items, junto con TotalCount, PageNumber y PageSize.

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

Materiales de personas realesCopy Anchor Link

Crea una sesión de verificación visual, completa H5, obtiene GroupId y llama a CreateAsset con ese grupo. Las cargas se comparan con el rostro verificado.

1. Crear sesión de verificación visual
2. Obtener resultado de verificación visual
3. Llamar a CreateAsset con el GroupId devuelto

ErroresCopy Anchor Link

Los errores mantienen el sobre Volcengine; código y mensaje están en 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.

Alternativa RESTCopy Anchor Link

Los endpoints REST /v1/videos/assets* siguen disponibles. Las nuevas integraciones pueden elegir REST snake_case; los clientes Volcengine no necesitan reformatear sus cuerpos. Materiales de Seedance y verificación de personas.

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

{  "id": "string"}