Langsung ke konten utama

​
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. Anda juga dapat memanggil dispatcher Action dengan CreateContentsGenerationsTasks, GetContentsGenerationsTask, ListContentsGenerationsTasks, atau DeleteContentsGenerationsTasks. Action dan Version tidak peka huruf besar-kecil. Version boleh dihilangkan; jika dikirim harus 2024-01-01. callback_url tidak diterima pada versi ini. Poll status tugas agar event selesai tidak terlewat. 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.
  • generate_audio default-nya true; setel false untuk video tanpa audio.
  • 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

curl https://api.tokenlab.sh/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {"type": "text", "text": "A cinematic forest at sunset"},
      {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/ref.png"}}
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "generate_audio": true
  }'