Ana içeriğe atla
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"
}
Bu endpoint’i, metinden veya metin artı referans görsellerden bir ByteDance Seedance video görevi başlatmak için kullanın. İstek hemen bir görev kimliği döndürür ve render işlemi eşzamansız olarak devam eder.

​
Geçerli model yolunu seçin

  • Güncel model kullanılabilirliği ve tanımlayıcıları için Models page sayfasını kullanın.
  • Bu rota için güncel üretim örneği olarak doubao-seedance-1-5-pro-251215 kullanın.
  • Aynı güncel model, birleşik content dizisi üzerinden hem yalnızca metin hem de görsel yönlendirmeli istekleri işleyebilir.

​
Görev akışı

1

content dizisini oluşturun

Ana metin talimatını önce yerleştirin, ardından yalnızca ilk kare veya son kare yönlendirmesine ihtiyaç duyduğunuzda görsel öğeleri ekleyin.
2

Görevi gönderin

Dönen görev kimliğini kaydedin. Push teslimat istiyorsanız, görevi oluştururken callback_url ayarlayın.
3

Çıktı gelene kadar sorgulayın

Görev tamamlanana ve content.video_url mevcut olana kadar ByteDance Video Query çağrısını yapın.

​
Bilinen wrapper davranışı

Volcengine ve Seedance, bu aileyi eşzamansız bir önce oluştur-sonra sorgula iş akışı olarak belgeler. CometAPI aynı görev modelini korur, ancak size tek bir temel URL ve tek bir API anahtarı sunar.
2026-03-12 tarihinde yapılan canlı doğrulama sırasında bu rota erişilebilirdi, ancak standart bir JSON örneği için yine de sunucu taraflı bir JSON ayrıştırma hatası döndürdü. Buradaki OpenAPI örneklerini pratik wrapper referansı olarak değerlendirin ve payload’inizi geliştirme sürecinin erken aşamasında doğrulayın.

Yetkilendirmeler

​
Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json
​
model
string
gerekli

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.

Örnek:

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

​
content
object[]
gerekli

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.

Yanıt

200 - application/json

Task accepted.

​
id
string
gerekli

Task id for later polling.