Seedance 2.0 API

API, Seedance 2.0 video oluşturma görevlerini programlı olarak göndermenizi sağlar. Oluşturma eşzamansızdır: bir görev oluşturun, hemen bir görev kimliği alın, ardından görev uç noktasını yoklayarak veya bir webhook alarak bitmiş videoyu alın.

Kontrol panelinde bir API anahtarı oluşturun ve her istekte Bearer token olarak gönderin. Anahtarın tamamı yalnızca oluşturma sırasında bir kez gösterilir.

Authorization: Bearer sk_live_xxxxxxxx

Önce bir görev gönderin. Görev kabul edildikten sonra bir sonuç teslim yöntemi seçin: görev uç noktasını sorgulayın veya terminal sonucunu bir webhook aracılığıyla alın.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

  return new Response(null, { status: 200 });
}

POST /v1/videos/generations ile bir video görevi oluşturun. İstek gövdesi üst düzey bir model, isteğe bağlı bir callback_url ve istem ve oluşturma ayarlarını içeren bir giriş nesnesi içerir.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

generation_type, hangi medya girişlerinin kabul edildiğini ve modelin bunları nasıl yorumladığını kontrol eder.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cinematic drone shot over a futuristic coastal city at sunrise",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "the subject turns toward camera, soft studio motion",
      "generation_type": "image-to-video",
      "image_urls": ["https://your.cdn.com/first-frame.jpg"],
      "duration": 5,
      "resolution": "720p"
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "use the product from image 1 and the camera motion from the reference video",
      "generation_type": "reference-to-video",
      "image_urls": ["https://your.cdn.com/product.jpg"],
      "video_urls": ["https://your.cdn.com/camera-motion.mp4"],
      "audio_urls": [],
      "duration": 8,
      "resolution": "1080p"
    }
  }'

Parametre adları, numara değerleri, uç nokta yolları ve örnekler API sözleşmesinin bir parçasıdır. Aşağıdaki açıklamalar her alanın nasıl davrandığını açıklar.

Bu, POST /v1/videos/generations'tan gelen başarılı yanıttır. Görevin kabul edildiği ve kredilerin rezerve edildiği anlamına gelir. Dönüştürülen taskId'yi GET /v1/tasks/:id'yi sorgulamak veya bir tamamlama veya başarısızlık geri çağrısını eşleştirmek için kullanın.

{
  "taskId": "3f2aK9mR...",
  "credits": 60
}

Mevcut görev durumunu almak için GET /v1/tasks/:id kullanın. Her 10 saniyede bir defadan fazla sorgulamayın. Üretim sistemleri için webhook'ları tercih edin.

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "charged",
  "credits": 60,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "refunded",
  "credits": 60,
  "failed_reason": "provider_failed"
}

callback_url mevcut olduğunda, Seedance, görev tamamlandığında veya başarısız olduğunda uç noktanızı çağırır ve nihai sonucu açıklayan JSON verilerini gönderir. Uç noktanız 2xx olmayan bir yanıt döndürürse veya 15 saniye içinde yanıt vermezse, teslimat 5 defaya kadar yeniden denenir. Yeniden denemeler aynı görev kimliğini kullanır, bu nedenle kimliğe göre tekrarı önleyin. Geri arama verilerini güvenli bir şekilde kaydettiğiniz anda 200 yanıtı döndürün.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 60
  }
}

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

  return new Response(null, { status: 200 });
}

POST /v1/videos/generations ve GET /v1/tasks/:id, API isteğinin kendisi başarısız olduğunda, örneğin geçersiz parametreler, geçersiz API anahtarı, yetersiz krediler, oran sınırlaması veya görev bulunamadığında bu hata şeklini döndürür. Bazı hatalar duruma bağlı olarak gerekli, mevcut veya retry_after gibi ek alanlar içerir.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this task.",
    "required": 60,
    "available": 12
  }
}

Oran sınırları, kayan bir pencere ile her API anahtarı başına uygulanır. Üretim varsayılan olarak dakikada 60 istektir; durum sorguları daha esnektir. HTTP 429 yanıtları Retry-After içerir.

API, gönderimde rezervasyon, başarıda tahsilat ve başarısızlıkta iade kullanır. Kontrol paneli kullanım sayfaları API kredi geçmişini, görev günlüklerini ve zamana dayalı kullanım istatistiklerini gösterir.