API Video Seedance

Pembuatan video Seedance memakai Video API asinkron. Kirim tugas terlebih dahulu, lalu periksa statusnya dengan ID tugas yang dikembalikan. API ini terpisah dari Chat Completions.

Sebelum memulai

Buat API key Modelflare dan gunakan https://modelflare.dev/v1 sebagai Base URL. Nama model publiknya adalah seedance-2.0 dan seedance-2.5.

Kombinasi durasi dan resolusi yang tersedia dapat berbeda menurut model. Periksa Model & Harga sebelum mengirim permintaan. Jika didukung, resolusinya adalah 480p, 720p, 1080p, atau 4k.

Permintaan teks ke video

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Seekor kucing putih berlari di jalan neon saat hujan, pengambilan gambar sinematik",
    "duration": 4,
    "resolution": "720p"
  }'

Permintaan gambar ke video

Tambahkan image berisi URL HTTPS gambar yang dapat diakses publik. Kolom lainnya sama dengan permintaan teks ke video.

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Subjek berputar perlahan menghadap kamera sementara kamera bergerak maju",
    "image": "https://example.com/reference.png",
    "duration": 4,
    "resolution": "720p"
  }'

Respons pengiriman

Pengiriman yang berhasil mengembalikan ID tugas publik. id dan task_id menunjuk tugas yang sama; simpan salah satunya.

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued"
}

Periksa status tugas

Periksa setiap beberapa detik. Status menunggu dapat berupa queued, pending, processing, atau in_progress. Hentikan saat status menjadi completed atau failed.

curl https://modelflare.dev/v1/videos/task_example_123 \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Contoh respons selesai:

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Unduh hasil

Setelah selesai, unduh video melalui endpoint content:

curl -L https://modelflare.dev/v1/videos/task_example_123/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -o seedance.mp4

Kolom permintaan utama

• model: wajib; seedance-2.0 atau seedance-2.5.
• prompt: wajib; deskripsi video.
• duration: wajib; bilangan bulat dalam detik, dengan minimum saat ini 4. seconds juga diterima.
• resolution: wajib; resolusi yang didukung model terpilih.
• image: opsional; URL HTTPS publik yang mengaktifkan gambar ke video.

HTTP 400 biasanya berarti parameter salah, 401 API key tidak valid, 429 batas sementara, dan kesalahan 5xx dapat dicoba lagi dengan jeda bertahap.