Seedance 2.0 API

API memungkinkan Anda mengirimkan tugas pembuatan video Seedance 2.0 secara terprogram. Pembuatan bersifat asinkron: buat tugas, segera terima ID tugas, lalu dapatkan video yang selesai dengan polling endpoint tugas atau dengan menerima webhook.

Buat kunci API di dasbor dan kirimkan sebagai token Bearer pada setiap permintaan. Kunci lengkap hanya ditampilkan sekali pada saat pembuatan.

Authorization: Bearer sk_live_xxxxxxxx

Kirim tugas terlebih dahulu. Setelah tugas diterima, pilih salah satu metode pengiriman hasil: polling endpoint tugas, atau terima hasil akhir melalui webhook.

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 });
}

Buat tugas video dengan POST /v1/videos/generations. Badan permintaan memiliki model tingkat atas, callback_url opsional, dan objek input yang berisi pengaturan prompt dan pembuatan.

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 mengontrol input media mana yang diterima dan bagaimana model menginterpretasikannya.

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"
    }
  }'

Nama parameter, nilai enum, jalur endpoint, dan contoh adalah bagian dari kontrak API. Deskripsi di bawah ini menjelaskan bagaimana setiap bidang berperilaku.

Ini adalah respons berhasil dari POST /v1/videos/generations. Ini berarti tugas telah diterima dan kredit telah dicadangkan. Gunakan taskId yang dikembalikan untuk polling GET /v1/tasks/:id atau untuk mencocokkan callback penyelesaian atau kegagalan.

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

Gunakan GET /v1/tasks/:id untuk mengambil status tugas saat ini. Polling tidak lebih dari sekali setiap 10 detik. Untuk sistem produksi, lebih pilih webhook.

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"
}

Ketika callback_url ada, Seedance memanggil endpoint Anda saat tugas selesai atau gagal, dan mengirimkan data JSON yang menjelaskan hasil akhir. Jika endpoint Anda mengembalikan respons non-2xx atau tidak merespons dalam waktu 15 detik, pengiriman akan dicoba ulang hingga 5 kali. Percobaan ulang menggunakan id tugas yang sama, jadi hapus duplikasi berdasarkan id. Kembalikan respons 200 segera setelah Anda berhasil merekam data callback.

{
  "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 dan GET /v1/tasks/:id mengembalikan bentuk kesalahan ini ketika permintaan API itu sendiri gagal, seperti parameter tidak valid, kunci API tidak valid, kredit tidak cukup, pembatasan laju, atau tugas tidak ditemukan. Beberapa kesalahan menyertakan bidang tambahan seperti required, available, atau retry_after tergantung pada situasinya.

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

Batas laju diterapkan per kunci API dengan jendela geser. Pembuatan default ke 60 permintaan per menit; kueri status lebih longgar. Respons HTTP 429 menyertakan Retry-After.

API menggunakan cadangan saat pengiriman, tagihan saat berhasil, dan pengembalian dana saat gagal. Halaman penggunaan Dasbor menunjukkan riwayat kredit API, log tugas, dan statistik penggunaan berdasarkan waktu.