seedance-2.0-fastAPI

Gunakan ID model yang tepat seedance-2.0-fast. Bidang model harus sama persis dengan halaman ini.

Otentikasi dan titik akhir

Gunakan kunci API Modelflare dengan https://modelflare.dev/v1. Titik masuk gateway adalah POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Buat tugas

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

Poll and download

Simpan ID tugas. Jajak pendapat GET /v1/videos/{task_id} dan unduh dengan GET /v1/videos/{task_id}/content. URL hasil mungkin kedaluwarsa, jadi segera transfer file.

bash

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

Minta catatan

Seedance menggunakan content[] untuk teks, bingkai, dan media referensi; kontrak manajemen aset Seedance yang terpisah didokumentasikan secara independen.

Parameter permintaan

Seedance menggunakan satu amplop multimodal asinkron. Masukkan teks dan media di content[]; peran media memilih alur kerja pertama/terakhir atau referensi.

Bidang	Wajib diisi	Catatan
model	Ya	seedance-2.0-fast
content[]	Ya	text, image_url, video_url, dan audio_url; gunakan role untuk mengidentifikasi tujuan media
resolution	Tidak	480p / 720p (standar 720p)
ratio	Tidak	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Tidak	-1 untuk pengaturan waktu otomatis, atau 4–15 detik
generate_audio	Tidak	Hasilkan dialog, efek, dan audio latar belakang yang tersinkronisasi
tools	Tidak	Gunakan web_search hanya jika halaman model resmi mendukungnya
watermark	Tidak	Apakah akan menambahkan tanda air

Batas masukan dan keluaran

Model ini mendukung 480p dan 720p. Gunakan -1 untuk pengaturan waktu otomatis atau pilih 4–15 detik; kecepatan bingkai ditetapkan pada 24fps. Referensi multimodal memungkinkan hingga sembilan gambar, tiga video, dan tiga klip audio; audio tidak dapat digunakan sendiri, jadi permintaan memerlukan setidaknya satu gambar atau video referensi. Tandai media dengan nilai role di content[]; alur kerja bingkai pertama, pengeditan, dan ekstensi saling eksklusif. Model ini tidak menerima frames, camera_fixed, output_format, atau omni_reference_task_type.

Contoh alur kerja yang terdokumentasi

Seri Seedance 2.0 mendukung teks-ke-video, bingkai pertama/pertama-dan-terakhir, referensi multimodal, pengeditan, ekstensi, dan pencarian web untuk teks-ke-video. Urutan media sebagai teks, gambar, video, lalu audio.

Referensi multimoda

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "content": [
      {"type": "text", "text": "@image1 performs the movement from @video1, paced to @audio1"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.jpg"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

Pengeditan video dan pencarian web

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

Kesalahan dan tugas yang gagal

Parameter model yang tidak valid menampilkan 4xx dengan ID permintaan. Tugas asinkron juga bisa gagal masuk setelah pembuatan berhasil; gunakan error_code dan error_message dari respon polling sebagai alasan tugas akhir. Jangan coba lagi permintaan yang sama dengan bentuk JSON yang berbeda.

Cakupan yang didukung

Halaman ini mencakup pembuatan model Modelflare dan panggilan pengeditan. Pengayaan penelusuran atau peta, pengelolaan suara, dan pengelolaan pustaka elemen merupakan API sumber daya di luar permukaan panggilan model publik ini dan bukan merupakan bidang permintaan yang wajib diisi.

Pricing and billing

Model ini menggunakan penagihan berbasis token. Lihat halaman harga model untuk harga pelanggan saat ini, harga daftar referensi, dan spesifikasi lengkap.

Catatan

Halaman ini mendokumentasikan antarmuka publik Modelflare; bidang dan batasan yang ditampilkan di sini adalah kontrak saat ini.