Seedance 2.0
Seedance 2.0
DokumentasiMemulai
Ikhtisar APITeks ke videoGambar ke video
Referensi API

Ikhtisar API

Pahami autentikasi, pengiriman job, pemeriksaan status, dan webhook di Seedance 2.0 Open API.

Seedance 2.0 Open API memungkinkan Anda mengirim job generasi video asinkron dari produk Anda sendiri dan mengambil hasilnya saat pemrosesan selesai.

Base URL

https://www.seedance2.ink

Authentication

Semua request Open API menggunakan Bearer token yang dibuat di dashboard Seedance.

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Alur integrasi

  1. Buat API Key di dashboard Seedance.
  2. Kirim job dengan POST /api/open/v1/video/generations.
  3. Simpan requestId yang dikembalikan.
  4. Lakukan polling ke GET /api/open/v1/video/generations/{requestId} hingga status akhir.
  5. Jika perlu, gunakan webhook untuk menerima notifikasi saat job selesai.

Endpoint utama

MethodEndpointDescription
GET/api/open/v1/modelsMenampilkan model, durasi, rasio, resolusi, dan informasi harga yang tersedia.
POST/api/open/v1/video/generationsMembuat job generasi video baru.
GET/api/open/v1/video/generations/{requestId}Memeriksa status job dan mengembalikan URL output saat siap.
POST/api/open/v1/video/generations/{requestId}/cancelMembatalkan job yang masih antre atau sedang diproses.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

Status

StatusDescription
queuedRequest diterima dan sedang menunggu di antrean.
processingGenerasi sedang diproses.
succeededJob selesai dengan sukses dan output.url tersedia.
failedJob gagal. Periksa error.
cancelledJob dibatalkan sebelum selesai.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

Anda dapat mengatur webhookUrl per request atau mengonfigurasi URL callback default di tingkat API Key.

  • Jika keduanya ada, webhookUrl pada request akan diprioritaskan.
  • Jika Webhook Secret dikonfigurasi, header x-seedance-signature akan ikut dikirim.
  • Webhook hanya dikirim saat job mencapai status akhir.
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

Kode error

HTTP statusError codeDescription
400invalid_requestBody request tidak sesuai dengan skema yang diharapkan.
401unauthorizedAPI Key tidak ada atau tidak valid.
402insufficient_creditsKredit tidak cukup untuk membuat job.
404not_foundJob tidak ditemukan untuk API Key saat ini.
429rate_limitedBatas per menit atau kuota bulanan terlampaui.
500internal_errorTerjadi error internal yang tidak terduga.

Langkah berikutnya

  • Baca Teks ke video
  • Baca Gambar ke video

Memulai

Cara tercepat untuk mulai produktif dengan Seedance 2.0.

Teks ke video

Buat video dari prompt teks dengan Seedance 2.0 Open API.

Daftar isi

Base URLAuthenticationAlur integrasiEndpoint utamaAvailable ModelsStatusModels Endpoint ExampleWebhookKode errorLangkah berikutnya