Seedance 2.5

Kemampuan

Harga & kredit

Pembuatan video dikenakan biaya dalam bentuk kredit berdasarkan durasi tagihan dalam hitungan detik. Tanpa input video, durasi tagihan adalah durasi output; dengan input video, durasi tagihan juga mencakup durasi video referensi.

Tabel di bawah ini mencantumkan biaya kredit yang dikenakan per detik, bukan total biaya dari suatu tugas. Tarif bergantung pada model, resolusi output, dan apakah video referensi disediakan dalam mode reference-to-video. Lihat rumus dan contoh di bawah tabel untuk perhitungan total biaya.

• Tanpa input video: detik output × tarif tanpa-video.
• Dengan input video: (detik output + detik video referensi yang terukur) × tarif dengan-video. Server mengukur total durasi video referensi dan membulatkannya ke atas ke detik terdekat sebelum penagihan.
• Referensi gambar atau audio saja menggunakan tarif tanpa-video. Tarif penagihan video referensi hanya berlaku dalam mode referensi-ke-video saat referensi video disertakan.

Kredit dicadangkan saat pengiriman dan didebit setelah berhasil. Tugas yang gagal atau habis waktu (timeout) akan masuk ke alur pengembalian dana. Status penagihan refund_failed berarti pengembalian dana tidak selesai; periksa log API atau hubungi dukungan.

Autentikasi

Buat kunci API di dasbor. Kunci lengkap hanya akan ditampilkan sekali. Simpan di server Anda dan kirimkan sebagai Bearer token pada setiap permintaan.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Atur variabel lingkungan SEEVIO_API_KEY sebelum menjalankan contoh ini. Contoh JavaScript dijalankan di server Anda menggunakan Node.js; contoh Python menggunakan paket requests.

Mulai cepat

Kirim permintaan minimal ini, simpan taskId yang dikembalikan, lalu gunakan contoh kueri tugas di bawah ini. Nilai kredit dalam respons pembuatan adalah jumlah yang dicadangkan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Contoh respons pembuatan tugas

Setelah permintaan di atas diterima, API akan mengembalikan respons JSON ini. taskId adalah pengenal tugas yang digunakan untuk kueri status berikutnya; credits adalah jumlah kredit yang dicadangkan untuk tugas ini. Respons ini hanya mengonfirmasi pembuatan tugas, bukan berarti video telah siap. Anda perlu melakukan polling status tugas atau menggunakan Webhook untuk menerima hasil video.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 100
}

Buat tugas

Kirim objek JSON yang berisi model dan input, serta callback_url opsional. Selalu tentukan ID model yang ditunjukkan pada halaman ini; mengosongkan model akan memilih seedance-2-0.

Isi permintaan

Parameter input

Berikan image_urls, video_urls, dan audio_urls dalam bentuk array string URL (string[]). Setiap URL yang dimasukkan harus dapat diakses secara publik melalui HTTPS, termasuk media yang diabaikan oleh mode yang dipilih.

Kolom boolean harus berupa JSON true atau false, bukan string atau angka.

Respons pembuatan

HTTP 200 mengembalikan taskId (string) dan credits (number). Ini menyatakan diterimanya pembuatan tugas, bukan penyelesaiannya. Jumlah di bawah ini sesuai dengan mulai cepat 720p berdurasi 5 detik.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 100
}

Mode pembuatan & contoh

Teks ke video

Hasilkan dari prompt teks. URL media tidak diteruskan dalam mode ini.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Bingkai pertama

Sediakan satu gambar sebagai bingkai pertama, lalu deskripsikan gerakannya dalam prompt Anda.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Bingkai pertama dan terakhir

Sediakan dua URL gambar secara berurutan: bingkai pertama, lalu bingkai terakhir. Contoh ini juga meminta bingkai terakhir dari video yang dihasilkan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Referensi multimodal

Gabungkan referensi gambar, video, dan audio. Prompt tetap wajib diisi. Input video referensi akan mengubah formula penagihan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Referensi audio

Gunakan audio sebagai satu-satunya jenis referensi, dengan prompt teks wajib yang mendeskripsikan video yang diinginkan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Pengeditan video

Deskripsikan pengeditan dan sertakan video sumber. Atur duration=-1 dan gunakan rasio aspek adaptif. Gunakan klip sumber minimal 4 detik untuk alur kerja ini. Aturan penagihan untuk duration=-1 ditunjukkan di atas.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Ekstensi video

Deskripsikan bagaimana kelanjutan video sumber seharusnya. Gunakan rasio aspek adaptif dan atur durasi output normal dalam rentang model.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Kueri tugas

Ganti ID contoh dengan taskId yang dikembalikan oleh pembuatan. Kueri hanya mengembalikan tugas milik pengguna dari kunci API tersebut; ID yang tidak dapat diakses atau tidak dikenal akan mengembalikan HTTP 404.

Lakukan polling setiap 10–20 detik sebagai permulaan, kurangi frekuensi pada HTTP 429, dan hentikan saat status telah selesai atau gagal. Gunakan webhook untuk produksi. Setiap contoh kode di bawah ini melakukan satu kueri.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

Tugas selesai: respons kueri dengan hasil video

Ketika kueri mengembalikan status=completed, pembuatan video telah selesai. Ambil URL video dari data.results dan unduh sebelum data.video_expires_at. billing_status=charged menunjukkan bahwa kredit yang dicadangkan telah terpotong.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Tugas gagal: respons kueri dengan detail kegagalan dan penagihan

Ketika kueri mengembalikan status=failed, proses pembuatan video gagal. Lihat failed_reason untuk mengetahui penyebabnya dan billing_status untuk hasil pengembalian dana. Pada contoh ini, refunded berarti kredit telah dikembalikan. credits tetap menampilkan jumlah awal yang dicadangkan, dan respons tidak menyertakan data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

Webhook

Atur callback_url dalam permintaan buat untuk menerima POST JSON saat tugas selesai atau gagal. Kembalikan respons 2xx dalam waktu 15 detik. Pengiriman yang gagal akan dicoba kembali; proses pengiriman berulang secara idempoten berdasarkan ID tugas.

Endpoint callback Anda harus menerima permintaan POST dengan body permintaan JSON (Content-Type: application/json).

Buat tugas dengan callback

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Muatan webhook berbeda dari respons kueri tugas: webhook tidak menyertakan billing_status dan credits; detail kegagalan ada di dalam data.failed_reason dan data.credits_refunded. created_at pada webhook adalah waktu pembuatan peristiwa dalam detik Unix.

Tugas selesai: payload callback sukses

Saat pembuatan berhasil, callback akan berisi status=completed. Gunakan id untuk mengidentifikasi tugas dan data.results untuk mengambil URL video. Unduh dan simpan hasilnya sebelum data.video_expires_at.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Tugas gagal: payload callback gagal

Saat pembuatan gagal, callback akan berisi status=failed. Gunakan id untuk mengidentifikasi tugas, data.failed_reason untuk melihat alasan kegagalan, dan data.credits_refunded untuk melihat jumlah kredit yang dikembalikan.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

Contoh penerima

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

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData.data;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

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

Contoh Next.js ini membaca body callback JSON dan menangani tugas yang berhasil serta gagal secara langsung. Tambahkan persistensi dan deduplikasi ID tugas untuk aplikasi Anda; antrekan pekerjaan yang lambat sebelum mengonfirmasi callback.

Persyaratan & batasan media

• Semua media dan URL callback harus berupa URL HTTPS publik. Hindari localhost, IP privat, dan file yang memerlukan cookie atau masuk log. URL referensi video/audio harus mengarah ke media yang dapat dibaca secara langsung.
• Dalam reference-to-video, sediakan setidaknya satu referensi, dengan tidak lebih dari 30 gambar, 10 video, 10 file audio, dan total gabungan 50 materi. Total durasi video dan total durasi audio masing-masing maksimal 30 detik.
• text-to-video mengabaikan semua referensi media. image-to-video hanya meneruskan gambar bingkai pertama/terakhir dan mengabaikan referensi video dan audio. Gunakan reference-to-video untuk menggabungkan media.
• Setiap referensi file video dan audio harus berdurasi 2–30 detik. Untuk contoh pengeditan video, gunakan klip sumber minimal 4 detik.

Error

Error HTTP memiliki objek error dengan kode dan pesan. Tugas yang berhasil diterima masih bisa gagal nanti; kueri tugas atau tangani callback kegagalannya.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

Batas frekuensi

Membuat tugas: secara default, setiap kunci API mengizinkan hingga 100 permintaan per menit. Batas frekuensi kustom saat ini belum tersedia.

Kueri tugas: secara default, setiap kunci API mengizinkan hingga 120 permintaan per menit. Permintaan kueri dan permintaan pembuatan tugas dihitung secara terpisah.