Video ve materyaller
Materyal Varlığı Oluştur
Bir Seedance materyal varlığını TokenLab materyal grubuna yükler.
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ür | Desteklenen girdi |
|---|---|
| Görsel | jpeg, 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]. |
| Video | mp4, mov; ≤200 MiB. |
| Ses | aac, 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 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