Seedance API

API ini memungkinkan Anda mengirimkan tugas pembuatan video Seedance 2.5 dan Seedance 2.0 secara programmatic. Seedance 2.5 adalah model yang direkomendasikan dan mendukung teks-ke-video, gambar-ke-video (bingkai pertama atau bingkai pertama dan terakhir), serta referensi multimodal ke video. Proses pembuatannya bersifat asinkron: buat tugas, terima ID tugas secara instan, lalu ambil video yang sudah selesai dengan melakukan polling ke endpoint tugas atau via webhook.

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

Authorization: Bearer sk_live_xxxxxxxx

Kirim tugas terlebih dahulu. Setelah tugas diterima, pilih salah satu metode pengambilan hasil: lakukan polling ke endpoint tugas, atau terima hasil akhir lewat webhook.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.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. Body permintaan berisi model tingkat atas, callback_url opsional, dan objek input yang berisi perintah teks (prompt) serta pengaturan pembuatan video.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

generation_type menentukan input media apa saja yang diterima dan bagaimana model menafsirkannya.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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": "720p"
    }
  }'

Nama parameter, nilai enum, path endpoint, dan contoh adalah bagian dari kontrak API. Deskripsi di bawah ini menjelaskan cara kerja dari setiap field.

Ini adalah respons sukses dari POST /v1/videos/generations. Respons ini menandakan bahwa tugas telah diterima dan kredit telah ditahan. Gunakan taskId yang dikembalikan untuk melakukan polling pada GET /v1/tasks/:id atau mencocokkannya dengan callback sukses atau gagal.

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

Gunakan GET /v1/tasks/:id untuk mendapatkan status tugas saat ini. Lakukan polling maksimal sekali setiap 10 detik. Untuk sistem produksi, sebaiknya gunakan webhook.

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

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

Jika callback_url disertakan, Seedance akan memanggil endpoint Anda setelah tugas selesai atau gagal dengan mengirimkan data JSON berisi hasil akhir. Jika endpoint Anda mengembalikan respons selain 2xx atau tidak merespons dalam 15 detik, pengiriman akan dicoba ulang hingga 5 kali. Upaya coba ulang menggunakan task id yang sama, jadi pastikan lakukan de-duplikasi berdasarkan ID tersebut. Segera kembalikan respons 200 begitu Anda berhasil menyimpan data callback dengan aman.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

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 akan mengembalikan struktur error ini jika permintaan API itu sendiri gagal, seperti parameter tidak valid, kunci API tidak sah, kredit tidak cukup, terkena batas frekuensi, atau tugas tidak ditemukan. Beberapa error menyertakan field tambahan seperti required, available, atau retry_after tergantung situasinya.

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

Batas frekuensi diterapkan per kunci API menggunakan metode sliding window. Default untuk pembuatan video adalah 100 permintaan per menit; kueri status tugas memiliki batas yang lebih longgar. Respons HTTP 429 menyertakan header Retry-After.

Sistem API menggunakan metode penahanan kredit saat pengiriman, pemotongan saat sukses, dan pengembalian saat gagal. Halaman penggunaan di dasbor menampilkan riwayat kredit API, log tugas, serta statistik penggunaan berdasarkan waktu.