Skip to main content

​
Ringkasan

Endpoint ini ditujukan untuk tim yang sudah memakai bentuk tugas Seedance bergaya Volc. Autentikasi memakai TokenLab Bearer API key. ID tugas yang dikembalikan diawali cgt-; polling status sampai status menjadi succeeded, failed, cancelled, atau expired. Kontrak task resmi menggunakan jalur REST di bawah /api/v3/contents/generations/tasks. Alias Action lama dipertahankan hanya untuk integrasi TokenLab terdahulu dan bukan bagian dari kontrak wire-compatible resmi. callback_url menerima alamat HTTP(S) publik. TokenLab mengirim objek query yang sama pada setiap perubahan ke queued, running, succeeded, failed, atau expired, tanpa header privat TokenLab. Status succeeded dan failed dicoba ulang hingga tiga kali setelah lima detik.
Untuk pemulihan aman setelah koneksi terputus, kirim Idempotency-Key unik pada create REST. Mengulang body dan key yang sama mengembalikan ID cgt-... yang sama; key yang sama dengan body berbeda mengembalikan 409. Ini tidak berlaku untuk rute Action lama.
Lihat juga Model Video Seedance 2.0 dan Pembuatan Video.

​
Aturan konten

  • Gunakan type=text untuk teks prompt.
  • type=image_url tanpa role diperlakukan sebagai frame pertama; Anda juga dapat menetapkan role=first_frame.
  • Gunakan role=last_frame hanya bersama frame pertama.
  • Gunakan role=reference_image, reference_video, atau reference_audio untuk media referensi.
  • Jangan mencampur input frame pertama/terakhir dengan media referensi dalam satu permintaan.

​
Catatan parameter

  • ratio menerima 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, atau adaptive.
  • Default resmi generate_audio adalah false; setel true saat audio tersinkron diperlukan.
  • service_tier=default diterima. Tugas kompatibel Seedance 2.0 menolak service_tier=flex, frames, dan camera_fixed=true.
  • Saat model yang dipilih mendukungnya, tools dapat berisi objek seperti { "type": "web_search" }. Entri tool yang salah format ditolak, bukan diabaikan.

​
Contoh