Seedance API: Buat Video Pertama Anda dengan Tiga Panggilan

Mulai job video Seedance, pantau statusnya, lalu unduh MP4-nya dengan HTTP biasa. Panduan lengkap dengan curl dan Python, beserta biaya setiap langkahnya.

3 menit baca

seedancevideotutorial

Pemandangan udara sebuah kota di sekitar menara tinggi, cuplikan dari video Seedance

Model video tidak menjawab dalam satu request seperti model chat. Pembuatan satu video memakan waktu satu hingga lima menit, sehingga API menjalankannya sebagai job: Anda memulainya, memeriksa statusnya, lalu mengambil file-nya setelah selesai. Postingan ini membahas ketiga panggilan tersebut dengan model Seedance, pertama dengan curl, lalu sebagai skrip Python singkat.

Anda memerlukan akun API Store dengan sedikit saldo dan API key dari halaman API key. Key diawali dengan sk-.

Langkah 1: mulai job

Kirim model, prompt, dan jika perlu durasi, resolusi, serta rasio aspek ke POST /videos:

bash
curl https://api.apistore.cloud/v1/videos \
  -H "Authorization: Bearer $APISTORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
    "seconds": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'

Jawabannya langsung kembali. Isinya id job dan statusnya:

json
{ "id": "video_8f2c...", "status": "queued", "model": "seedance-2.0-mini" }

Jika Anda tidak mengisi field opsional, Anda mendapatkan video 5 detik pada 720p dalam 16:9, dengan suara. Suara (ucapan, musik, dan efek) dibuat bersamaan dengan gambarnya; kirim "audio": false jika Anda tidak menginginkannya.

Langkah 2: polling sampai selesai

Minta status job setiap beberapa detik:

bash
curl https://api.apistore.cloud/v1/videos/video_8f2c... \
  -H "Authorization: Bearer $APISTORE_API_KEY"

status berpindah dari queued ke in_progress, lalu berakhir sebagai completed atau failed. Job yang selesai juga membawa usage.video_tokens dan usage.cost_usd, sehingga Anda tahu persis berapa biayanya. Job yang gagal membawa error.code dan error.message dan tidak ditagih.

Langkah 3: unduh file-nya

Job yang selesai memiliki url: tautan ke MP4 yang berlaku selama seminggu dan diperbarui setiap kali Anda membaca job tersebut. Anda juga selalu bisa mengambil file-nya melalui API:

bash
curl -L https://api.apistore.cloud/v1/videos/video_8f2c.../content \
  -H "Authorization: Bearer $APISTORE_API_KEY" -o boat.mp4

Hal yang sama dalam Python

Tidak perlu SDK: paket requests sudah cukup.

python
import os, time, requests

BASE = "https://api.apistore.cloud/v1"
HEAD = {"Authorization": f"Bearer {os.environ['APISTORE_API_KEY']}"}

job = requests.post(f"{BASE}/videos", headers=HEAD, json={
    "model": "seedance-2.0-mini",
    "prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
    "seconds": 5,
    "resolution": "720p",
}).json()

while job["status"] not in ("completed", "failed"):
    time.sleep(5)
    job = requests.get(f"{BASE}/videos/{job['id']}", headers=HEAD).json()

if job["status"] == "failed":
    raise SystemExit(f"{job['error']['code']}: {job['error']['message']}")

video = requests.get(f"{BASE}/videos/{job['id']}/content", headers=HEAD)
open("boat.mp4", "wb").write(video.content)
print("cost", job["usage"]["cost_usd"], "USD")

Berapa biayanya

Video ditagih berdasarkan video yang benar-benar dibuat oleh model. Harganya bergantung pada model dan resolusi, dan situs menampilkannya per detik output. Seedance 2.0 mini pada 480p, kombinasi termurah saat ini, berharga US$0,0202 per detik, dan US$0,0454 per detik pada 720p.

Saat job dimulai, biaya hasil terpanjang yang mungkin dihasilkannya ditahan dari saldo Anda. Saat selesai, Anda membayar untuk apa yang dibuat dan sisanya dilepaskan. Jika job gagal, tidak ada yang ditagih. Cara penagihan pembuatan video menjelaskan angka-angkanya secara rinci.

Model mana untuk memulai

  • Seedance 2.0 mini untuk uji coba dan draf: harga terendah, 480p dan 720p.
  • Seedance 2.0 fast saat Anda menginginkan kualitas lebih baik dengan harga menengah.
  • Seedance 2.0 untuk gambar terbaik dari keluarga 2.0, hingga 1080p dan 4K.
  • Seedance 2.5 untuk video panjang hingga 30 detik, banyak file referensi, serta mengedit atau memperpanjang video.

Keempatnya menerima request yang sama, jadi Anda bisa berganti model dengan mengubah satu kata. Memilih model Seedance membandingkan keempatnya berdampingan.

Langkah berikutnya

  • Berikan model sebuah frame pertama atau gambar referensi: lihat dokumentasi video.
  • Coba prompt di playground sebelum Anda menulis kode.
  • Periksa daftar harga untuk setiap model dan resolusi.

Juga di English, Tiếng Việt, Español, Português