Genel bakış
Bu endpoint’ler, Volc tarzı Seedance görev şeklini zaten kullanan ekipler içindir. Kimlik doğrulama TokenLab Bearer API key ile yapılır. Dönen görev ID’sicgt- ile başlar; status succeeded, failed, cancelled veya expired olana kadar durumu sorgulayın.
Resmî görev sözleşmesi /api/v3/contents/generations/tasks altındaki REST yollarını kullanır. Eski Action takma adları yalnızca mevcut TokenLab entegrasyonları için korunur ve resmî wire-compatible sözleşmenin parçası değildir.
callback_url, genel bir HTTP(S) adresini kabul eder. TokenLab, queued, running, succeeded, failed veya expired durumlarına her geçişte sorgu nesnesinin aynısını özel TokenLab header’ları olmadan gönderir. succeeded ve failed beş saniye sonra en fazla üç kez yeniden denenir.
Bağlantı koptuktan sonra güvenli kurtarma için REST oluşturma isteğinde benzersiz bir
Idempotency-Key gönderin. Aynı body ve key ile tekrar denemek aynı cgt-... ID’sini döndürür; aynı key’i farklı bir body ile kullanmak 409 döndürür. Bu davranış eski Action rotası için geçerli değildir.İçerik kuralları
- Prompt metni için
type=textkullanın. roleolmayantype=image_urlilk kare olarak işlenir; istersenizrole=first_frameda belirtebilirsiniz.role=last_frameyalnızca ilk kareyle birlikte kullanılabilir.- Referans medya için
role=reference_image,reference_videoveyareference_audiokullanın. - Aynı istekte ilk/son kare girdileriyle referans medyayı karıştırmayın.
Parametre notları
ratio16:9,4:3,1:1,3:4,9:16,21:9veyaadaptivekabul eder.generate_audioiçin resmî varsayılanfalsedeğeridir; eşzamanlı ses gerektiğindetruegönderin.service_tier=defaultkabul edilir. Seedance 2.0 uyumlu görevleriservice_tier=flex,framesvecamera_fixed=truedeğerlerini reddeder.- Seçilen model destekliyorsa
tools,{ "type": "web_search" }gibi nesneler içerebilir. Hatalı tool öğeleri yok sayılmak yerine reddedilir.