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çinCopy Anchor Link

Materyal KavramlarıCopy Anchor Link

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

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.

Materyal SaklamaCopy Anchor Link

TokenLab, siz varlığı veya grubunu silene kadar her materyal varlığını saklar. TokenLab tarafında hareketsizlik nedeniyle temizlenmez.

Upstream Seedance sağlayıcısı, 30 gün kullanılmayan bir varlığın kendi çalışma kopyasını kaldırabilir. Bu, varlığınızı silmez ve kimliğini değiştirmez: varlığı bir sonraki oluşturma isteğinde kullandığınızda TokenLab, saklanan orijinalden otomatik olarak yeni bir upstream kopyası hazırlar.

• Temizlikten sonraki ilk oluşturma, yeni kopya hazırlanırken biraz daha uzun sürebilir. Kopya henüz hazır değilse istek seedance_material_preparing döndürür; kısa süre sonra tekrar deneyin.
• Bir varlığı veya grubu silmek kalıcıdır ve geri alınamaz.

Görsel URL’leri ve yeniden kullanılabilir materyallerCopy Anchor Link

Seçilen modelin desteklediği görsel alanlarında herkese açık HTTP(S) URL’leri veya desteklenen data URL’lerini gönderin. Bunlar normal medya girdisi olarak işlenir ve otomatik olarak yeniden kullanılabilir materyal kimliği oluşturmaz.

Yeniden kullanmak için materyal API’siyle varlık oluşturun, ACTIVE durumunu bekleyin ve desteklenen medya alanında material_asset_id, material_asset_ids veya asset://<id> kullanın. İlk kare, son kare veya referans görsel rolünü koruyun.

Açıkça belirtilen materyal hâlâ hazırlanıyorsa POST /v1/videos/generations, inactive_asset_ids ile 409 seedance_material_preparing döndürür. Varlıkları ACTIVE olana kadar sorgulayıp aynı kimliklerle yeniden deneyin. FAILED durumunda önce error_message değerine göre düzeltin veya yeniden içe aktarın.

Gerçek Kişi Materyal DoğrulamasıCopy Anchor Link

Ü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.

1. CallbackURL ile Görsel doğrulama oturumu oluştur çağrısı yapın ve döndürülen Result.BytedToken değerini kaydedin.
2. 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.
3. H5 akışı tamamlandığında tarayıcı, bytedToken ve resultCode gibi resmi sorgu adlarıyla Result.CallbackURL adresini açar.
4. Result.GroupId dönene kadar BytedToken ile Görsel doğrulama sonucunu al çağrısını tekrarlayın.
5. 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.

Dönen H5Link adresini oluşturulduktan hemen sonra açın. Token geçerliliği, doğrulama sayfasının bu sürenin herhangi bir anında ilk kez açılabileceğini garanti etmez.

İ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şturmaCopy Anchor Link

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üklemeCopy Anchor Link

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.

Tablo dosya içe aktarma sınırlarını gösterir. Kabul edilen istek medya veya gerçek kişi doğrulamasının geçeceğini garanti etmez. ACTIVE durumunu bekleyin; FAILED olursa yeniden içe aktarmadan önce error_message doğrultusunda kaynağı düzeltin.

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. Upstream kopyası temizlenirse otomatik olarak yeniden oluşturulur; yukarıdaki saklama bölümüne bakın.

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ıCopy Anchor Link

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 ActionCopy Anchor Link

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 ÖrnekleriCopy Anchor Link

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ışıCopy Anchor Link

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.