seedance-2.0API

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

Contoh keluaranseedance-2.0POST /v1/videos5.1s

Parameter: duration=5resolution=1080pratio=16:9

Prompt: One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

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",
    "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.

Catatan

Unggah gambar orang virtual ke pustaka aset Seedance terlebih dahulu. Tunggu hingga statusnya Active, lalu gunakan asset://<ID> di content[]. Modelflare tidak menyediakan verifikasi orang nyata.

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
content[]	Ya	text, image_url, video_url, dan audio_url; gunakan role untuk mengidentifikasi tujuan media
resolution	Tidak	480p / 720p / 1080p / 4k (standar 720p)
ratio	Tidak	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Tidak	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 output 480p, 720p, 1080p, dan 4k dengan durasi 4–15 detik. Referensi multimodal memungkinkan hingga sembilan gambar, tiga video, dan tiga klip audio; audio tidak dapat digunakan sendiri. Tandai media dengan nilai role di content[]; alur kerja bingkai pertama, pengeditan, ekstensi, dan penelusuran web memiliki batasannya masing-masing. Gambar orang virtual harus diunggah ke pustaka aset terlebih dahulu; Modelflare tidak menyediakan verifikasi orang nyata.

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",
    "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", "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.

Varian

ID Model	Perbedaan
seedance-2.0	Model didokumentasikan di halaman ini.