TokenLab Seedance Materyalleri: Prodüksiyon İş Akışları için Yeniden Kullanılabilir Video Referansları

Yeniden kullanılabilir video referansları, her üretim isteğine kopyalanan tek seferlik URL'ler yerine yaşam döngüsü durumuna sahip varlıklar olduklarında yönetilmeleri daha kolaydır. Eğer daha önce bir görüntü bağlantıları tablosu tuttuysanız, aynı referans videosunu beş kez yeniden yüklediyseniz veya üç farklı API çağrısına aynı yüz değiştirme (face-swap) URL'sini tekrar tekrar yazdıysanız, Seedance materyallerinin çözmek için tasarlandığı sorunu zaten anlıyorsunuz demektir.

TokenLab'in Seedance materyal kütüphanesi, video ekiplerine referansları üretim çağrıları genelinde depolamak, doğrulamak ve yeniden kullanmak için organizasyon kapsamlı bir yol sunar. Bu makale, bir materyal varlığının aslında ne olduğunu, materyal gruplarının bireysel varlıklarla nasıl ilişkili olduğunu, otomatik hazırlığın nasıl çalıştığını ve gerçek kişi doğrulamasının iş akışına nerede oturduğunu açıklamaktadır.

Önemli Çıkarımlar

• Materyal varlığı (material asset), üretime hazır referans nesnesidir; materyal grubu (material group) ise, özellikle gerçek kişi iş akışları için ilgili varlıkları düzenleyen kapsayıcıdır.
• Bir materyal varlığının id değerini, durumu ACTIVE seviyesine ulaştıktan sonra material_asset_id olarak (veya material_asset_ids içinde) kullanın.
• İki kütüphane türü mevcuttur: Sanal avatar ve diğer gerçek kişi olmayan yeniden kullanılabilir referanslar için aigc_avatar ve doğrulama gerektiren gerçek kişi materyal grupları için liveness_face.
• TokenLab, uyumlu görüntü girdilerini (image, image_url, image_urls, reference_images, start_image, end_image) ayrı bir yükleme adımı olmaksızın otomatik olarak materyal varlıklarına dönüştürebilir.
• Hazırlık süreci 60 saniyeyi aşarsa, API 409 seedance_material_preparing yanıtını ve sorgulayıp yeniden deneyebileceğiniz auto_material_asset_ids değerlerini döndürür.
• Seedance 2.0, Seedance 2.0 Fast ve Seedance 2.0 Mini, bu materyal sisteminin desteklediği güncel genel modellerdir. Belirli bir katmana bağımlılık oluşturmadan önce dokümanlardaki model bazlı yetenek detaylarını doğrulayın.

Seedance Materyali Nedir?

Seedance materyali; TokenLab'in istek kapsamlı bir URL yerine organizasyon kapsamlı bir varlık olarak sakladığı, yeniden kullanılabilir bir referanstır (görüntü, video veya ses). Her create-video çağrısına ham bir dosya bağlantısı geçirmek yerine, referansı bir kez yükler veya içe aktarırsınız, üretime hazır hale gelmesini beklersiniz ve ardından ihtiyaç duyduğunuz kadar sonraki çağrıda ID ile referans verirsiniz.

Bu durum üç pratik nedenden dolayı önemlidir.

Birincisi, tekrarlanan yüklemeler bant genişliğini boşa harcar ve özellikle büyük referans videoları için her isteğe gecikme ekler.

İkincisi, ham URL'lerin süresi dolar, değiştirilir veya orijinal olarak barındırıldıkları depolama sistemi tarafından iptal edilir. TokenLab tarafından yönetilen bir materyal varlığı bu kırılganlığa sahip değildir.

Üçüncüsü ve karakter tutarlılığı veya marka tutarlılığı olan video hatları oluşturan ekipler için en önemlisi; materyaller, her seferinde üretim mantığınıza dokunmadan sürümünü oluşturabileceğiniz, denetleyebileceğiniz ve değiştirebileceğiniz kararlı bir tanımlayıcı sağlar.

Materyal Varlıkları ve Materyal Grupları

Bu sistemdeki iki temel nesne materyal varlığı ve materyal varlık grubudur; API referansını dikkatlice okumadıysanız bunları karıştırmak kolaydır.

Materyal varlığı tek bir referans nesnesidir; bir avatar görüntüsü, doğrulanmış bir canlı yüz veya bir referans video klibi. Bunu oluşturduğunuzda, API bir id döndürür. Varlık ACTIVE durumuna ulaştığında video üretim çağrılarına geçireceğiniz değer bu id'dir.

Materyal varlık grubu, group_id ile tanımlanan bir kapsayıcıdır. Gruplar ilgili varlıkları bir arada düzenler ve bireysel varlıkların içine yüklenebilmesinden önce doğrulamanın grup düzeyinde gerçekleştiği gerçek kişi (liveness_face) iş akışları için yapısal olarak gereklidir.

Kısacası: group_id düzenler; material_asset_id üretir. API'nin farklı bölümlerinde her iki alanı da göreceksiniz; yanlış olanı yanlış yerde kullanmak, ekiplerin bu sistemle yaptığı en yaygın entegrasyon hatasıdır.

Alan	Tanımladığı şey	Nerede kullanılır
group_id	Bir materyal varlık grubu (kapsayıcı)	Bir grup oluştururken veya referans verirken, özellikle gerçek kişi doğrulama akışlarında
id (materyal varlığında)	Tek bir yeniden kullanılabilir referans	ACTIVE olduğunda material_asset_id olur
material_asset_id	Tekil bir varlık referansı	Bir referans yuvası için create-video içine geçirilir
material_asset_ids	Varlık referanslarından oluşan bir dizi	Birden fazla yeniden kullanılabilir referans gerektiğinde create-video içine geçirilir

Tam alan tanımları ve gerekli parametreler create material asset ve create material asset group API referanslarında belgelenmiştir. Bunu üretim koduna bağlamadan önce bunları okuyun; bu makale iş akışının şeklini kapsar, her istek parametresini değil.

Sanal Avatar ve Gerçek Kişi İş Akışları

Seedance materyalleri iki kütüphane türünü destekler ve bu ayrım sadece kozmetik değildir; iki farklı güvenlik ve onay duruşunu yansıtır.

aigc_avatar: Sanal Avatarlar ve Gerçek Kişi Olmayan Referanslar

aigc_avatar türü, doğrulanmış bir gerçek kişiye bağlı olmayan yeniden kullanılabilir referansları kapsar: resimli karakterler, sentetik avatarlar, stilize figürler, ürün maskotları ve benzeri varlıklar. Bunlar, bir doğrulama adımı olmaksızın doğrudan materyal varlığı oluşturma akışı üzerinden oluşturulabilir.

Ürününüz kurgusal karakterler veya marka avatarları etrafında videolar üretiyorsa, bu neredeyse kesinlikle istediğiniz kütüphane türüdür. Kimlik doğrulama gereksinimi olmadığı için daha basit bir oluşturma yoluna sahiptir.

liveness_face: Gerçek Kişi Materyal Grupları

liveness_face türü, gerçek bir kişinin benzerliği etrafında oluşturulan materyal grupları içindir; gerçek bir bireyi içeren yüz tutarlı video üretimi için kullanılan referans türüdür. Bu, kimlik ve onay süreçlerine dokunduğu için TokenLab, varlıklar gruba yüklenmeden önce bir doğrulama akışı gerektirir.

Doğrulama dizisi birkaç farklı adımdan oluşur:

1. Oturum oluşturma — arka ucunuz grup için bir doğrulama oturumu talep eder.
2. H5 akışı — doğrulanan kişi, barındırılan bir web akışı aracılığıyla canlılık kontrolünü tamamlar ("H5" ifadesi şuna atıfta bulunur: mobil web doğrulama arayüzü).
3. Geri arama (Callback) — doğrulama oturumu sona erdiğinde TokenLab sisteminizi bilgilendirir.
4. Sonucu bağlama (Bind result) — doğrulanan kimlik materyal grubuna bağlanır.
5. Grup kapsamlı yüklemeler — yalnızca bağlama işlemi başarılı olduktan sonra materyal varlıkları o belirli gruba yüklenebilir.

Bu, gerçek kişi materyallerinin doğası gereği grup öncelikli olduğu anlamına gelir: aigc_avatar ile yapabildiğiniz gibi doğrudan varlık oluşturmaya geçemezsiniz. Grubun var olması ve herhangi bir varlık yüklemesi geçerli olmadan önce doğrulamayı geçmesi gerekir.

Kontrol Listesi: Doğru Kütüphane Türünü Seçmek

• Referans gerçek, tanımlanabilir bir kişinin yüzü veya benzerliği mi? → liveness_face kullanın ve doğrulama akışını planlayın.
• Referans sentetik, resimli veya gerçek kişi olmayan bir avatar mı? → aigc_avatar kullanın ve doğrulamayı atlayın.
• Ürününüz aynı gerçek kişi için birden fazla üretimde tutarlı kimliğe ihtiyaç duyuyor mu? → Grubu bir kez oluşturun, bir kez doğrulayın, gelecekteki varlıklar için grubu yeniden kullanın.
• Müşteri tarafından sağlanan bir referansın hangi türe girdiğinden emin değil misiniz? → Aksi kanıtlanana kadar liveness_face olarak değerlendirin; dokümanlardan doğrulayın, varsayımda bulunmayın.

Her üretim modelinin veya her istek türünün her iki kütüphane türünü de aynı şekilde desteklediğini varsaymayın — bir mimariye karar vermeden önce Seedance 2.0 Video Models guide içindeki güncel destek detaylarını doğrulayın.

Otomatik Materyal Hazırlığı Nasıl Çalışır?

Her referans manuel bir yükleme adımı gerektirmez. TokenLab, uyumlu görüntü girdilerini bir üretim isteğinin parçası olarak otomatik olarak materyal varlıklarına hazırlayabilir; bu da basit durumlar için bir gidiş-dönüş süresini ortadan kaldırır.

Otomatik hazırlık için tanıdığı alanlar şunlardır:

• image
• image_url
• image_urls
• reference_images
• start_image
• end_image

Bunlardan herhangi birini doğrudan bir üretim çağrısına geçirirseniz, TokenLab materyal varlığı uç noktasını önce ayrı olarak çağırmanızı gerektirmek yerine, içe aktarma ve hazırlık işlemlerini arka planda halleder.

Hazırlık 60 Saniyeden Uzun Sürdüğünde Ne Olur?

Hazırlık genellikle hızlıdır, ancak daha büyük veya daha karmaşık referans görüntülerinin üretime hazır bir varlığa dönüştürülmesi daha uzun sürebilir. Hazırlık 60 saniyeyi aşarsa, API şu yanıtı verir:

409 seedance_material_preparing

bununla birlikte hala hazırlanmakta olan varlıkların ID'lerini içeren bir auto_material_asset_ids alanı döner.

Bu, geleneksel anlamda bir hata değildir; yeniden deneme için bir sinyaldir. Entegrasyonunuz 409 seedance_material_preparing yanıtını son kullanıcıya yansıtılacak bir başarısızlık olarak değil, "kısa süre sonra tekrar kontrol et" yanıtı olarak değerlendirmelidir. Döndürülen varlık ID'lerini sorgulayın, ACTIVE durumunu bekleyin ve ardından bu ID'leri kullanarak üretime devam edin.

Pratikte bu, üretim hattınızın sadece tek bir try/catch değil, küçük bir yeniden deneme döngüsüne ihtiyaç duyduğu anlamına gelir. Otomatik video hatları oluşturan ekipler bu durumu, hız sınırı (rate-limit) geri çekilmesine nasıl yaklaşıyorlarsa öyle ele almalıdır; beklenen, geçici ve kullanıcıya hata olarak raporlanmak yerine kod içinde yönetilen bir durum.

Üretimde Materyaller Nasıl Kullanılır?

Bir materyal varlığı — manuel olarak yüklenmiş veya otomatik olarak hazırlanmış olsun — ACTIVE durumuna ulaştığında, id değeri bir create video çağrısında material_asset_id olarak (veya material_asset_ids içinde bir girdi olarak) kullanılabilir hale gelir.

Temel iş akışı şöyledir:

1. Referansın gerçek kişi olup olmadığına karar verin. Buna göre liveness_face (doğrulamalı) veya aigc_avatar seçin.
2. Gerçek kişi ise: materyal grubunu oluşturun, doğrulama oturumunu ve H5 akışını çalıştırın, geri aramayı alın ve sonucu bağlayın.
3. Materyal varlığını oluşturun veya içe aktarın — doğrudan yükleme çağrısı yoluyla veya otomatik hazırlığın bir üretim isteği içindeki uyumlu bir görüntü alanını işlemesine izin vererek.
4. Durumu kontrol edin. Varlık ID'sini ACTIVE rapor edene kadar üretime geçirmeyin.
5. 409 seedance_material_preparing alırsanız, döndürülen auto_material_asset_ids değerlerini sorgulayın ve ACTIVE durumuna geçtiklerinde yeniden deneyin.
6. id değerini, gecikme ve kalite ihtiyaçlarınıza bağlı olarak seedance-2.0, seedance-2.0-fast veya seedance-2.0-mini gibi güncel bir Seedance modelini hedefleyerek create-video çağrınızda material_asset_id olarak veya material_asset_ids içinde kullanın.
7. Referansı yeniden yüklemek yerine, aynı varlık ID'sini gelecekteki üretim çağrılarında yeniden kullanın.

Görev yönetimi de burada önemlidir. Yeniden kullanılan bir materyal varlığı üzerine kurulu bir üretim çağrısının çalışma ortasında durdurulması gerekiyorsa — maliyet kontrolü, değişen bir yaratıcı brief veya hatalı bir istem nedeniyle — iptal işleminin devam eden video işleriyle nasıl etkileşime girdiğini öğrenmek için Seedance task cancellation hakkındaki tamamlayıcı yazımıza bakın.

TokenLab'deki video üretim modellerinde halihazırda nelerin mevcut olduğuna dair daha geniş bir karşılaştırma için video models category page mevcut seçenekleri yan yana listeler.

Pratik Sonraki Adımlar

• Prototip oluşturuyorsanız, aigc_avatar materyalleriyle başlayın; oluşturma yolu daha basittir ve etrafında inşa edilecek bir doğrulama bağımlılığı yoktur.
• Ürününüz gerçek kişi tutarlılığı gerektiriyorsa, doğrulama akışını (oturum → H5 → geri arama → bağlama) işe alım sürecinizin birinci sınıf bir parçası haline getirin, sonradan eklenen bir özellik olarak değil.
• Üretime herhangi bir şey göndermeden önce 409 seedance_material_preparing için bir yeniden deneme döngüsü ekleyin; bunu bir uç durum (edge case) olarak değil, beklenen bir davranış olarak ele alın.
• Materyal varlık ID'lerini kendi dahili referans kayıtlarınızla birlikte saklayın, böylece hangi varlığın hangi karakterle veya ürünle eşleştiğini tekrar türetmek zorunda kalmazsınız.
• material asset ve material asset group API referanslarını doğrudan inceleyin; bu makale iş akışının şeklini tanımlar ve entegrasyon kodunu yazmadan önce kesin istek/yanıt alanları güncel dokümanlara göre doğrulanmalıdır.

Zaten oluşturduğunuz varlıkların durumunu, kütüphane türünü ve grup ilişkilerini görmek için materyal kütüphanesine doğrudan Seedance assets dashboard üzerinden göz atabilirsiniz.

Bir üretim iş akışına karar vermeden önce, maliyetlerin kullanımla nasıl ölçeklendiğini anlamak için AI video API pricing 2026 genel bakışımızdaki güncel oranları incelemeye değer. Ayrıca TokenLab dashboard usage exports içindeki rehberliği kullanarak kendi kullanım verilerinizi takip edebilir ve dışa aktarabilirsiniz.

SSS

Seedance materyal varlığı nedir? Materyal varlığı, kendi yaşam döngüsü durumuna sahip, organizasyon kapsamlı bir nesne olarak saklanan, yeniden kullanılabilir bir video üretim referansıdır (görüntü, video veya ses). ACTIVE durumuna ulaştığında, her seferinde ham bir URL sağlamak yerine ID ile birden fazla üretim çağrısında referans verebilirsiniz.

group_id ve material_asset_id arasındaki fark nedir? group_id, öncelikle gerçek kişi (liveness_face) varlıklarını düzenlemek ve doğrulamayı grup düzeyinde yönetmek için kullanılan bir kapsayıcı olan materyal varlık grubunu tanımlar. material_asset_id, tek bir yeniden kullanılabilir referansı — bir materyal varlığı oluşturulduğunda döndürülen id — tanımlar ve video üretim çağrılarına geçirdiğiniz değerdir.

Gerçek kişi doğrulamasını ne zaman kullanmalıyım? Referans materyali gerçek, tanımlanabilir bir kişinin yüzünü veya benzerliğini içerdiğinde liveness_face türünü ve doğrulama akışını kullanın. Akış, o gruba herhangi bir varlık yüklenebilmesi için oturum oluşturma, H5 canlılık kontrolü, geri arama ve bağlama adımı gerektirir. Resimli veya sentetik avatarlar gibi gerçek kişi olmayan referanslar aigc_avatar kullanır ve bu doğrulama yolunu gerektirmez.

seedance_material_preparing ne anlama gelir? Bu, bir üretim isteğindeki image_url veya start_image gibi uyumlu görüntü alanlarının tetiklediği otomatik materyal hazırlığı 60 saniyeden uzun sürdüğünde döndürülen bir 409 yanıtıdır. Yanıt, ACTIVE durumuna geçtiklerinde o ID'leri sorgulayıp üretimi yeniden deneyebilmeniz için auto_material_asset_ids içerir. Bu, bir başarısızlığı değil, geçici bir devam eden durumu işaret eder.

Kaynaklar ve Güncellik

• Seedance 2.0 Video Models guide — https://docs.tokenlab.sh/guides/seedance-2-video — gözlemlenen 2026-07-09
• Create Seedance material asset (API reference) — https://docs.tokenlab.sh/api-reference/video/create-material-asset — gözlemlenen 2026-07-09
• Create Seedance material asset group (API reference) — https://docs.tokenlab.sh/api-reference/video/create-material-asset-group — gözlemlenen 2026-07-09
• Create video (API reference) — https://docs.tokenlab.sh/api-reference/video/create-video — gözlemlenen 2026-07-09
• TokenLab Seedance assets dashboard — https://tokenlab.sh/en/dashboard/seedance-assets — gözlemlenen 2026-07-09

Burada açıklanan API davranışı, alan adları ve durum semantiği, gözlem tarihi itibarıyla genel dokümantasyonu ve panel kopyasını yansıtmaktadır. TokenLab'in Seedance materyal sistemi aktif geliştirme aşamasındadır — üretim entegrasyon kodunu tamamlamadan önce güncel parametre adlarını, durum değerlerini ve modele özel desteği bağlantılı dokümanlardan doğrulayın.

Kararlı, yeniden kullanılabilir referanslara dayanan bir video hattı oluşturuyorsanız, Seedance 2.0 Video Models guide ile başlayın — güncel parametre adlarını görmenin ve hedef model katmanınızın aslında neyi desteklediğini doğrulamanın en hızlı yolu budur.