Video ve materyaller

Materyal Varlığı Oluştur

Bir Seedance materyal varlığını TokenLab materyal grubuna yükler.

POST
/v1/videos/assets

Halka açık erişilebilir bir kaynak URL'sini bir Seedance materyal grubuna içe 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; belirtilmediği takdirde 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. project_name değeri default olmadığında da group_id zorunludur. Grup, aynı project_name ve library_type değerine ait olmalıdır, aksi takdirde istek 400 hatası döndürür.

TürDesteklenen girdi
Görseljpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; genişlik ve yükseklik [300, 6000] px; en-boy oranı [0.4, 2.5].
Videomp4, mov; ≤200 MiB.
Sesaac, wav, mp3; ≤15 MiB.

TokenLab, isteği kabul etmeden önce kaynak URL'sini, medya türünü, dosya boyutunu ve görsel okunabiliyorsa boyutlarını kontrol eder. Bu kontrollerden geçemeyen bir kaynak, seedance_material_source_* koduyla birlikte 400 hatası döndürür; örneğin seedance_material_source_invalid (görsel boyutları veya en-boy oranı aralık dışı), seedance_material_source_type_mismatch, seedance_material_source_too_large veya seedance_material_source_url_unreachable. Diğer medya ve yüz gereksinimleri işleme sırasında değerlendirilir, bu nedenle kabul edilmiş olması varlığın hazır olduğu anlamına gelmez: ACTIVE durumuna geçmesini bekleyin ve işleme başarısız olursa error_message alanını inceleyin.

Başarılı bir istek, status: "PROCESSING" ile birlikte 201 kodu döndürür. status değeri ACTIVE olana kadar Materyal Varlığını Al 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 bir yüz içeren yüklemeler başarısız olabilir.

project_name, organizasyonunuz içindeki kaynakları kapsar ve varsayılan olarak default değerini alır. İlgili gruplar ve varlıklar için aynı büyük/küçük harfe duyarlı değeri kullanın. POST/PUT işlemleri için JSON gövdesinde, GET/DELETE işlemleri için ise sorgu dizesinde (query string) gönderin.

Örnek İstek

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ıt

{
  "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,
  "updated_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}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json