Actions de materiais (compatíveis com Volcengine)

Estes endpoints aceitam as Actions e os campos de materiais abaixo, com autenticação Bearer do TokenLab e o envelope ResponseMetadata + Result.

Endpoint e autenticaçãoCopy 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 também é aceito. Todas as Actions de materiais usam apenas POST. Uma solicitação apenas com assinatura AK/SK retorna 401 InvalidCredential.

ProjectName usa default por padrão e é uma fronteira real de isolamento na organização autenticada. Use o mesmo valor nas solicitações relacionadas.

Actions de gruposCopy Anchor Link

CreateAssetGroup cria apenas grupos AIGC. Um grupo LivenessFace é criado após verificação bem-sucedida; ListAssetGroups filtra ambos os tipos.

Criar 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 materiaisCopy Anchor Link

AssetType aceita Image, Video e Audio. O grupo de destino determina se é material AIGC comum ou LivenessFace verificado.

Use IDs de materiais do TokenLab. CreateAsset retorna Result.Id antes do fim do processamento; consulte GetAsset até Result.Status ser Active ou Failed. ListAssets também aceita SortBy: "GroupId".

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

Comportamento das listasCopy Anchor Link

PageNumber usa 1 por padrão; PageSize usa 10 e aceita até 100. SortBy aceita CreateTime ou UpdateTime; SortOrder aceita Desc ou Asc.

Os estados são Active, Processing e Failed. URLs temporárias de GetAsset e ListAssets valem por 12 horas. Guarde Id como identidade permanente.

ListAssetGroups e ListAssets retornam recursos em Result.Items, junto com TotalCount, PageNumber e PageSize.

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

Materiais de pessoas reaisCopy Anchor Link

Crie uma sessão de verificação visual, conclua a verificação H5, obtenha GroupId e chame CreateAsset nesse grupo. Os uploads são comparados ao rosto verificado.

1. Criar sessão de verificação visual
2. Obter resultado da verificação visual
3. Chamar CreateAsset com o GroupId retornado

ErrosCopy Anchor Link

Erros preservam o envelope Volcengine; código e mensagem ficam em 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

Os endpoints REST /v1/videos/assets* continuam disponíveis. Novas integrações podem escolher REST snake_case; clientes Volcengine não precisam reformular seus corpos. Materiais Seedance e verificação de pessoas.

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

{  "id": "string"}