seedance-2.5API

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

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

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

Prompt: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, 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.5",
    "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.5
content[]	Ya	text, image_url, video_url, dan audio_url; gunakan role untuk mengidentifikasi tujuan media
resolution	Tidak	480p / 720p / 1080p
ratio	Tidak	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Tidak	-1 untuk pengaturan waktu otomatis, atau 4–30 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
omni_reference_task_type	Tidak	auto / reference / edit / extend; pengeditan dan ekstensi menerapkan aturan rasio/durasi yang lebih ketat
output_format	Tidak	mp4 / mov
return_last_frame	Tidak	Mengembalikan frame terakhir sebagai gambar

Batas masukan dan keluaran

Model ini mendukung 480p, 720p, dan 1080p. Gunakan -1 untuk pengaturan waktu otomatis atau pilih 4–30 detik. Permintaan dapat menggabungkan hingga 30 gambar, 10 video, dan 10 klip audio. Pembuatan referensi biasa menerima rasio eksplisit atau adaptive; pengeditan, ekstensi, dan alur kerja bingkai pertama/terakhir memerlukan ratio: "adaptive", dan pengeditan memerlukan duration: -1. Gambar orang virtual harus diunggah ke pustaka aset terlebih dahulu; Modelflare tidak menyediakan verifikasi orang nyata.

Contoh alur kerja yang terdokumentasi

Seedance 2.5 mengklasifikasikan alur kerja referensi, pengeditan, ekstensi, dan panduan bingkai berdasarkan peran media dan jenis tugas. Contoh-contoh ini mempertahankan kontrak resmi saat menggunakan titik akhir Modelflare dan ID model.

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.5",
    "omni_reference_task_type": "reference",
    "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"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Pengeditan video

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Ekstensi video

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Bingkai pertama dan terakhir

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

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.5	Model didokumentasikan di halaman ini.