Seedance 2.0 API API Belgeleri

Seedance 2.0 video oluşturmayı uygulamanıza entegre etmek için ihtiyacınız olan her şey.

Temel URL

https://api.defapi.org

Kimlik Doğrulama

Tüm API istekleri Authorization başlığında bir API anahtarı gerektirir.

Authorization: Bearer <your-api-key>

Örnek: Bearer dk-1234567890abcdef

API Anahtarı Al

POST/api/video/seedance/gen

Seedance AI ile video oluşturun. Yoklama için task_id döner.

İstek Gövdesi

Parametre	Tür	Zorunlu	Açıklama
model	string	Hayır	Kullanılacak AI modeli. Varsayılan: seedance-2.0
content	array	Evet	Metin/resim URL öğelerinden oluşan dizi. Maks. 9 resim. @image1, @image2… ile başvurun
duration	integer	Hayır	Saniye cinsinden video süresi. Seçenekler: 5, 10, 15. Varsayılan: 5
ratio	string	Hayır	En boy oranı. Seçenekler: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. Varsayılan: 16:9
callback_url	string	Hayır	Görev tamamlama bildirimleri için Webhook URL'si

Örnekler

Metinden videoya

POST https://api.defapi.org/api/video/seedance/gen
Authorization: Bearer dk-1234567890abcdef
Content-Type: application/json

{
  "model": "seedance-2.0",
  "content": [
    { "type": "text", "text": "A beautiful beach scene with waves gently lapping at the shore" }
  ]
}

Görüntüden videoya (@image1, @image2 ile görüntüye başvurun)

{
  "model": "seedance-2.0",
  "content": [
    { "type": "text", "text": "The cat in @image1 walks through a garden, then meets the dog in @image2" },
    { "type": "image_url", "image_url": { "url": "https://example.com/cat.png" } },
    { "type": "image_url", "image_url": { "url": "https://example.com/dog.png" } }
  ],
  "duration": 5,
  "callback_url": "https://example.com/webhook/video-callback"
}

Yanıt

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

GET/api/task/query

Video oluşturma görevinin durumunu ve sonucunu sorgulayın.

Sorgu Parametreleri

Parametre	Tür	Zorunlu	Açıklama
task_id	string	Evet	Oluşturma uç noktasının döndürdüğü Görev Kimliği

Örnekler

GET https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071
Authorization: Bearer dk-1234567890abcdef

Yanıt

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta823dfb-eaac-44fd-aec2-3e2c7ba8e071",
    "status": "success",
    "result": { "video": "https://example.com/generated-video.mp4" },
    "consumed": "0.500000",
    "status_reason": { "message": null },
    "created_at": "2025-08-03T10:22:20.010Z"
  }
}

Hata Kodları

HTTP Durumu	code alanı	Anlam
200	0	Başarı
400	1	Hatalı istek — geçersiz parametreler
401	1	Yetkisiz — API anahtarı eksik veya geçersiz
404	1	Görev bulunamadı
500	1	Dahili sunucu hatası

Seedance 2.0 API ile oluşturmaya başla