Seedance materyalleri ve gerçek kişi doğrulaması

Seedance materyalleri kuruluş içinde yeniden kullanılabilen görsel, video veya ses referanslarıdır. Önce iş akışını seçin: normal avatar materyali ile doğrulanmış gerçek kişi materyalinin oluşturma yolu farklıdır.

Materyal iş akışını seçin

Amaç	Gerekli akış
Bir görsel URL’sini bir kez kullanmak	URL’yi doğrudan video isteğinde gönderin; uyumlu model materyali otomatik hazırlar
Avatar, ürün veya stili yeniden kullanmak	`aigc_avatar` grubu ve materyal oluşturun, `ACTIVE` durumunu bekleyin ve ID’yi kullanın
Gerçek kişiyi yeniden kullanmak	Görsel doğrulamayı tamamlayın, `GroupId` alın, materyal oluşturun, `ACTIVE` durumunu bekleyin ve ID’yi kullanın
Volcengine materyal istemcisini taşımak	Action şeklini koruyup Volcengine uyumlu referansı kullanın: Materyal Action’ları (Volcengine uyumlu)

Materyal Kavramları

Seedance materyalleri, video oluşturma sırasında daha sonra seçilebilen, organizasyon kapsamındaki yeniden kullanılabilir referanslardır.

Kavram	Genel alan	Anlamı
Materyal grubu	`group_id`	İlgili Seedance materyallerine sahip olan bir TokenLab grubu. Materyalleri yüklerken veya listelerken kullanın.
Materyal varlığı	`id`	Yüklenmiş bir görsel, video veya ses dosyası. Varlık `ACTIVE` durumuna geldikten sonra bu değeri `material_asset_id` olarak kullanın.
Sanal avatar materyal grubu	`library_type: "aigc_avatar"`	Sanal insanlar, avatarlar, ürünler, stiller ve gerçek kişi doğrulaması gerektirmeyen diğer yeniden kullanılabilir referanslar için.
Gerçek kişi materyal grubu	`library_type: "liveness_face"`	Gerçek kişi materyal doğrulaması ile oluşturulur. Bir grup, doğrulanmış bir gerçek kişiyi temsil eder.

group_id ve materyal varlığı id değerlerini ayrı tutun. group_id yüklemeleri düzenlemek içindir; materyal varlığı id ise video oluşturma içindir. Bir video isteği Seedance material asset not found or not accessible hatası döndürürse, group_id değil, bir materyal varlığı id değeri gönderdiğinizden; varlığın aynı organizasyona ait olduğundan, silinmediğinden ve status: "ACTIVE" durumunda olduğundan emin olun.

Otomatik Görsel Materyalleri

Seçilen Seedance modeli TokenLab materyal kitaplığını kullanabiliyorsa, görsel URL’lerini veya desteklenen inline data URL’lerini doğrudan image, image_url, image_urls, reference_images, start_image ya da end_image alanlarında gönderebilirsiniz. TokenLab bu görselleri kuruluşun varsayılan sanal avatar materyal grubuna aktarır ve ilk kare, son kare veya referans görsel rollerini korur. Materyaller 60 saniye içinde ACTIVE olursa oluşturma aynı istekte devam eder. Aksi halde API, auto_material_asset_ids ile 409 seedance_material_preparing döndürür; bu materyaller ACTIVE olana kadar sorgulayın ve ardından material_asset_id veya material_asset_ids ile tekrar deneyin. Seçilen model materyal kitaplığını kullanamıyorsa normal görsel URL’leri veya data URL’leri standart görsel yolunda kalır; açık materyal ID’leri yeniden denenebilir materyal kullanılabilirliği hatasıyla güvenli şekilde başarısız olur. Mevcut sanal avatar ve gerçek kişi materyal ID’leri olduğu gibi kullanılır ve yeniden içe aktarılmaz.

Gerçek Kişi Materyal Doğrulaması

Ürününüz, bir gerçek kişinin yeniden kullanılabilir bir Seedance referansı olarak kullanılabilmesi için onay ve yüz doğrulaması gerektiriyorsa gerçek kişi materyal doğrulamasını kullanın.

CallbackURL ile Görsel doğrulama oturumu oluştur çağrısı yapın ve döndürülen Result.BytedToken değerini kaydedin.
Doğrulanacak kişi için Result.H5Link bağlantısını açın. Belirli bir dil gerekiyorsa H5 bağlantısına lng ekleyin.
H5 akışı tamamlandığında tarayıcı, bytedToken ve resultCode gibi resmi sorgu adlarıyla Result.CallbackURL adresini açar.
Result.GroupId dönene kadar BytedToken ile Görsel doğrulama sonucunu al çağrısını tekrarlayın.
GroupId değerini kaydedin ve liveness_face materyalleri oluştururken group_id olarak kullanın.

BytedToken 30 dakika geçerlidir. Her iki Action isteğinde aynı ProjectName değerini kullanın. Kimlik doğrulamada Authorization: Bearer <TOKENLAB_API_KEY> kullanılır; Volc AK/SK imzaları kabul edilmez. İsteğe bağlı: İstek ve geri çağırma (callback) akışınızı doğrulamak, materyal gruplarını incelemek ve doğrulama geçmişini gözden geçirmek için test konsolunu kullanın. Üretim (production) entegrasyonunuz API’leri doğrudan çağırmalıdır.

Materyal Grupları Oluşturma

aigc_avatar grupları için Materyal Varlık Grubu Oluştur kullanın. Yeni gerçek kişi grupları, doğrulanmış kişi ile materyal grubunun bağlantılı kalması için doğrulama akışı üzerinden oluşturulur. Gruplar oluşturulduktan sonra yönetmek için Materyal Varlık Gruplarını Listele, Materyal Varlık Grubunu Getir, Materyal Varlık Grubunu Güncelle ve Materyal Varlık Grubunu Sil kullanın. Bir materyal grubunu silmek, içindeki TokenLab materyallerini de siler ve bu işlem geri alınamaz. TokenLab materyal kütüphanesi, mevcut yetkilendirme durumu izin vermediği için silme işlemini tamamlayamazsa, TokenLab nötr bir materyal kütüphanesi hatası döndürür.

Materyal Yükleme

Her seferinde genel olarak erişilebilir bir kaynak URL’sini içe aktarmak için Materyal Varlığı Oluştur kullanın. aigc_avatar için group_id isteğe bağlıdır; TokenLab, organizasyonun varsayılan sanal avatar grubunu kullanır veya oluşturur. liveness_face için group_id zorunludur ve Görsel doğrulama sonucunu al tarafından döndürülen grup olmalıdır.

Tür	Desteklenen girdi
Görsel	`jpeg`, `png`, `webp`, `bmp`, `tiff`, `gif`, `heic`, `heif`; en-boy oranı `(0.4, 2.5)`; genişlik ve yükseklik `(300, 6000)` px; 30 MB altı.
Video	`mp4`, `mov`; `480p`, `720p` veya `1080p`; 2-15 saniye; en-boy oranı `[0.4, 2.5]`; genişlik ve yükseklik `[300, 6000]` px; toplam piksel 409600 ile 2068676 arası; 200 MB’a kadar; 24-60 FPS.
Ses	`aac`, `wav`, `mp3`; 2-15 saniye; 15 MB’a kadar.

Materyal alımı asenkrondur. status değeri ACTIVE olana kadar Materyal Varlığını Getir ile sorgulama yapın. Başarılı bir HTTP yanıtı, yalnızca isteğin kabul edildiği anlamına gelir; her zaman iş durumunu (business status) okuyun. Durum FAILED ise error_message kısmını inceleyin, kaynak materyali düzeltin ve yeni bir varlık oluşturun. Materyal oluşturma isteklerinde asset_url yalnızca içe aktarma kaynağıdır. TokenLab bir materyal varlığı id değeri döndürür; üretim için özgün URL yerine bu id değerini kullanın. TokenLab, materyal varlıklarını siz varlığı veya materyal grubunu silene kadar organizasyonunuzun materyal kitaplığında tutar. Gerçek kişi materyal grupları için bir grup, bir gerçek kişiyle eşleşir. Yüklemeler, doğrulanmış yüze göre kontrol edilir. Birden fazla yüz içeren veya doğrulanmış kişiyle eşleşmeyen bir yüze sahip varlıklar başarısız olabilir. En iyi sonuçlar için hem tam vücut önden referans görseli hem de yüzün net olduğu önden yakın çekim bir görsel yükleyin.

Video Oluşturmada Materyal Kullanımı

Bir varlık ACTIVE olduktan sonra, Video oluştur çağrısı yaparken dönen TokenLab varlık id değerini material_asset_id olarak iletin veya material_asset_ids içine dahil edin. Materyal varlıkları, Seedance referans limitlerine dahil edilir.

REST veya Volcengine Action

TokenLab’e özgü entegrasyonlar snake_case /v1/videos/assets* REST API’yi kullanmaya devam edebilir. Mevcut Volcengine istemcileri PascalCase gövdeleri koruyup Volcengine uyumlu materyal Action’larını kullanabilir. İki arayüz aynı kuruluş ve proje kapsamındaki materyal verisini işler.

API Örnekleri

Bir sanal avatar grubu oluşturun, bir görsel yükleyin, aktif olana kadar sorgulayın ve ardından video isteğinde materyal varlığı kimliğini kullanın.

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references"}'

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-abc12","asset_url":"https://example.com/reference.png","asset_type":"Image"}'

curl https://api.tokenlab.sh/v1/videos/assets/asset-20260720123457-def45 \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Gerçek kişi materyal grubu için materyalleri yüklemeden önce bir görsel doğrulama oturumu oluşturun ve sonucu alın.

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

Gerçek kişi için tam Action akışı

Doğrulama sonucunun döndürdüğü GroupId değerini CreateAsset çağrısına verin.

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-real1",
    "URL":"https://example.com/person-front.png",
    "Name":"Verified front view",
    "AssetType":"Image",
    "ProjectName":"default"
  }'

Durum Active olana kadar GetAsset çağrısını polling yapın ve dönen materyal ID’sini video üretiminde kullanın.

Başlarken

Temel kılavuzlar

Medya kılavuzları

Seedance materyalleri ve gerçek kişi doğrulaması

Materyal iş akışını seçin

Materyal Kavramları

Otomatik Görsel Materyalleri

Gerçek Kişi Materyal Doğrulaması

Materyal Grupları Oluşturma

Materyal Yükleme

Video Oluşturmada Materyal Kullanımı

REST veya Volcengine Action

API Örnekleri

Gerçek kişi için tam Action akışı

​Materyal iş akışını seçin

​Materyal Kavramları

​Otomatik Görsel Materyalleri

​Gerçek Kişi Materyal Doğrulaması

​Materyal Grupları Oluşturma

​Materyal Yükleme

​Video Oluşturmada Materyal Kullanımı

​REST veya Volcengine Action

​API Örnekleri

​Gerçek kişi için tam Action akışı

Materyal iş akışını seçin

Materyal Kavramları

Otomatik Görsel Materyalleri

Gerçek Kişi Materyal Doğrulaması

Materyal Grupları Oluşturma

Materyal Yükleme

Video Oluşturmada Materyal Kullanımı

REST veya Volcengine Action

API Örnekleri

Gerçek kişi için tam Action akışı