Materyal Varlığı Oluştur

Halka açık erişilebilir bir kaynak URL'sini bir Seedance materyal grubuna aktarın. TokenLab, materyali daha sonra kullanmak üzere saklar; üretim için kaynak URL'sini değil, döndürülen materyal varlığı id değerini kullanın.

library_type: "aigc_avatar" için group_id isteğe bağlıdır; TokenLab, organizasyonun varsayılan sanal avatar grubunu kullanır veya oluşturur. library_type: "liveness_face" için group_id zorunludur ve Görsel doğrulama sonucunu al tarafından döndürülen TokenLab grubu olmalıdır.

TokenLab kaynak URL’sini, medya türünü, dosya boyutunu ve okunabilen görsel boyutlarını kontrol eder. İçe aktarmanın kabul edilmesi varlığın hazır olduğu anlamına gelmez: ACTIVE durumunu bekleyin, işlem başarısızsa error_message alanına bakın. Diğer medya ve yüz koşulları işlem sırasında doğrulanır.

Oluşturma işlemi asenkrondur. status değeri ACTIVE olana kadar Materyal Varlığını Getir uç noktasını sorgulayın. Gerçek kişi grupları için, bir grup doğrulanmış bir kişiyle eşleşir; birden fazla yüz içeren veya doğrulanmış kişiyle eşleşmeyen yüzlere sahip yüklemeler başarısız olabilir.

project_name, kimliği doğrulanmış organizasyon içindeki kaynakları ayırır. Varsayılanı default değeridir; ilgili grup ve varlıklarda büyük/küçük harfe duyarlı aynı değeri kullanın. POST/PUT için JSON gövdesinde, GET/DELETE için sorgu parametresi olarak gönderin.

Örnek İstekCopy Anchor Link

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'

Örnek YanıtCopy Anchor Link

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view",
  "asset_type": "Image",
  "status": "PROCESSING",
  "ready": false,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000
}

curl -X POST "https://example.com/v1/videos/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_url": "https://example.com/reference.png",    "asset_name": "Front view",    "asset_type": "Image",    "library_type": "aigc_avatar",    "group_id": "group-20260720123456-vrt01"  }'

{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view",  "asset_type": "Image",  "status": "PROCESSING",  "ready": false,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}