소재 Action(Volcengine 호환)

이 엔드포인트는 아래 소재 Action과 필드를 지원하며 TokenLab Bearer 인증과 ResponseMetadata + Result 형식을 사용합니다.

엔드포인트 및 인증Copy 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도 지원합니다. 모든 소재 Action은 POST 전용입니다. AK/SK 서명만 있는 요청은 401 InvalidCredential을 반환합니다.

ProjectName의 기본값은 default이며 인증된 조직 내부의 실제 격리 경계입니다. 관련 생성, 목록, 조회, 수정, 삭제 요청에 같은 값을 사용하세요.

소재 그룹 ActionCopy Anchor Link

CreateAssetGroup은 AIGC 그룹만 생성합니다. LivenessFace 그룹은 실존 인물 인증 성공 시 생성되며 ListAssetGroups는 두 그룹 유형을 모두 필터링할 수 있습니다.

소재 그룹 생성Copy 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"}
}

소재 ActionCopy Anchor Link

AssetType은 Image, Video, Audio를 지원합니다. 대상 그룹이 일반 AIGC 소재인지 인증된 LivenessFace 소재인지 결정합니다.

TokenLab 소재 ID를 사용하세요. CreateAsset은 처리 완료 전에 Result.Id를 반환합니다. Result.Status가 Active 또는 Failed가 될 때까지 GetAsset을 폴링하세요. ListAssets는 SortBy: "GroupId"도 지원합니다.

소재 생성Copy 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"}'

목록 동작Copy Anchor Link

PageNumber 기본값은 1, PageSize 기본값은 10이고 최대 100입니다. SortBy는 CreateTime 또는 UpdateTime, SortOrder는 Desc 또는 Asc입니다.

소재 상태는 Active, Processing, Failed입니다. GetAsset과 ListAssets가 반환하는 임시 URL은 12시간 동안 유효합니다. 영구 식별자로 Id를 저장하세요.

ListAssetGroups와 ListAssets는 Result.Items에 리소스를 반환하며 TotalCount, PageNumber, PageSize도 함께 제공합니다.

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

실존 인물 소재Copy Anchor Link

시각 인증 세션을 만들고 H5 인증을 완료한 뒤 결과의 GroupId로 CreateAsset을 호출합니다. 업로드는 인증된 얼굴과 비교됩니다.

1. 시각 인증 세션 생성
2. 시각 인증 결과 조회
3. 반환된 GroupId로 CreateAsset 호출

오류Copy Anchor Link

오류도 Volcengine 응답 envelope을 사용하며 코드와 메시지는 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.

REST 대안Copy Anchor Link

TokenLab의 /v1/videos/assets* REST API도 계속 사용할 수 있습니다. 새 통합은 snake_case REST를 선택할 수 있고 기존 Volcengine 클라이언트는 본문을 바꿀 필요가 없습니다. Seedance 소재 및 실존 인물 인증.

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

{  "id": "string"}