Langsung ke konten utama
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
Gunakan endpoint ini untuk memulai task video ByteDance Seedance dari teks, atau dari teks ditambah gambar referensi. Request akan segera mengembalikan task id dan proses render berlanjut secara asynchronous.

Pilih path model saat ini

  • Gunakan halaman Models untuk melihat ketersediaan dan identifier model saat ini.
  • Gunakan doubao-seedance-1-5-pro-251215 sebagai contoh production saat ini untuk route ini.
  • Model saat ini yang sama dapat menangani request hanya-teks maupun request dengan panduan gambar melalui array content yang terintegrasi.

Alur task

1

Bangun array content

Tempatkan instruksi teks utama terlebih dahulu, lalu tambahkan item gambar hanya saat Anda membutuhkan panduan frame pertama atau frame terakhir.
2

Kirim task

Simpan task id yang dikembalikan. Jika Anda ingin pengiriman push, set callback_url saat Anda membuat task.
3

Poll sampai output tersedia

Panggil ByteDance Video Query hingga task selesai dan content.video_url tersedia.

Perilaku wrapper yang diketahui

Volcengine dan Seedance mendokumentasikan keluarga ini sebagai alur kerja asynchronous create-then-query. CometAPI mempertahankan pola task yang sama tetapi memberi Anda satu base URL dan satu API key.
Selama validasi langsung pada 2026-03-12, route ini dapat diakses tetapi masih mengembalikan error parse JSON di sisi server untuk sampel JSON standar. Anggap contoh OpenAPI di sini sebagai referensi wrapper yang praktis, dan validasi payload Anda lebih awal dalam pengembangan.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
model
string
wajib

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

Contoh:

"doubao-seedance-1-5-pro-251215"

content
object[]
wajib

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

callback_url
string

Optional webhook URL for task status notifications.

Respons

200 - application/json

Task accepted.

id
string
wajib

Task id for later polling.