Materyal Action’ları (Volcengine uyumlu)

Bu uç noktalar, aşağıdaki materyal Action ve alanlarını TokenLab Bearer kimlik doğrulaması ve ResponseMetadata + Result zarfıyla destekler.

Endpoint ve kimlik doğrulamaCopy 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 de desteklenir. Tüm materyal Action’ları yalnızca POST kabul eder. Yalnızca AK/SK imzası bulunan istek 401 InvalidCredential döndürür.

ProjectName varsayılan olarak default değerini alır ve doğrulanmış kuruluş içinde gerçek bir yalıtım sınırıdır. İlişkili isteklerde aynı değeri kullanın.

Materyal grubu Action’larıCopy Anchor Link

CreateAssetGroup yalnızca AIGC grubu oluşturur. LivenessFace grubu başarılı kişi doğrulamasından sonra oluşturulur; ListAssetGroups iki türü de filtreleyebilir.

Materyal grubu oluşturmaCopy 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"}
}

Materyal Action’larıCopy Anchor Link

AssetType, Image, Video ve Audio değerlerini kabul eder. Hedef grup materyalin normal AIGC mi yoksa doğrulanmış LivenessFace mı olduğunu belirler.

TokenLab materyal kimliklerini kullanın. CreateAsset, işlem tamamlanmadan Result.Id döndürür; Result.Status değeri Active veya Failed olana kadar GetAsset sorgulayın. ListAssets ayrıca SortBy: "GroupId" kabul eder.

Materyal oluşturmaCopy 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"}'

Liste davranışıCopy Anchor Link

PageNumber varsayılanı 1, PageSize varsayılanı 10 ve üst sınırı 100dür. SortBy, CreateTime veya UpdateTime; SortOrder, Desc veya Asc kabul eder.

Materyal durumları Active, Processing ve Failed değerleridir. GetAsset ve ListAssets geçici URL’leri 12 saat geçerlidir. Kalıcı kimlik olarak Id değerini saklayın.

ListAssetGroups ve ListAssets, kaynakları Result.Items içinde; TotalCount, PageNumber ve PageSize ile birlikte döndürür.

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

Gerçek kişi materyalleriCopy Anchor Link

Görsel doğrulama oturumu oluşturun, H5 doğrulamasını tamamlayın, GroupId alın ve bu grupla CreateAsset çağırın. Yüklemeler doğrulanmış yüzle karşılaştırılır.

1. Görsel doğrulama oturumu oluştur
2. Görsel doğrulama sonucunu al
3. Dönen GroupId ile CreateAsset çağırma

HatalarCopy Anchor Link

Hatalar Volcengine yanıt zarfını korur; kod ve mesaj ResponseMetadata.Error altında yer alır.

{
  "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 alternatifiCopy Anchor Link

TokenLab /v1/videos/assets* REST endpoint’leri kullanılmaya devam eder. Yeni entegrasyonlar snake_case REST’i seçebilir; mevcut Volcengine istemcilerinin gövdeleri değiştirmesi gerekmez. Seedance materyalleri ve gerçek kişi doğrulaması.

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

{  "id": "string"}