Skip to main content

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’si cgt- 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.
Ayrıca bkz. Seedance 2.0 Video Modelleri ve Video Oluşturma.

İçerik kuralları

  • Prompt metni için type=text kullanın.
  • role olmayan type=image_url ilk kare olarak işlenir; isterseniz role=first_frame da belirtebilirsiniz.
  • role=last_frame yalnızca ilk kareyle birlikte kullanılabilir.
  • Referans medya için role=reference_image, reference_video veya reference_audio kullanın.
  • Aynı istekte ilk/son kare girdileriyle referans medyayı karıştırmayın.

Parametre notları

  • ratio 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 veya adaptive kabul eder.
  • generate_audio için resmî varsayılan false değeridir; eşzamanlı ses gerektiğinde true gönderin.
  • service_tier=default kabul edilir. Seedance 2.0 uyumlu görevleri service_tier=flex, frames ve camera_fixed=true değerlerini reddeder.
  • Seçilen model destekliyorsa tools, { "type": "web_search" } gibi nesneler içerebilir. Hatalı tool öğeleri yok sayılmak yerine reddedilir.

Örnek