wan3.0-video-primeAPI

Gunakan ID model yang tepat wan3.0-video-prime. Bidang model harus sama persis dengan halaman ini.

Contoh keluaranwan3.0-video-primePOST /v1/videos5.0s

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

Prompt: A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "wan3.0-video-prime",
  "prompt": "A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, 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": "wan3.0-video-prime",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

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

Wan biasanya menggunakan input dan parameters; mode panduan bingkai dan media referensi tidak boleh dicampur.

Parameter permintaan

Wan3.0 menggunakan input.prompt atau input.media dengan kontrol output di parameters. Media dapat mewakili bingkai, referensi, audio, file, atau halaman web.

Bidang	Wajib diisi	Catatan
model	Ya	wan3.0-video-prime
input.prompt	Bersyarat	Provide this or input.media
input.media[]	Bersyarat	first_frame, last_frame, reference_*, file, atau link
parameters.resolution	Tidak	480P / 720P / 1080P (standar 1080P)
parameters.ratio	Tidak	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	Tidak	2–30 detik, atau -1 untuk durasi otomatis
parameters.audio	Tidak	Apakah akan menghasilkan audio yang disinkronkan
parameters.prompt_extend	Tidak	Tetapkan salah ketika kontrak model khusus ini memerlukannya
parameters.seed	Tidak	Benih acak opsional
parameters.watermark	Tidak	Apakah akan menambahkan tanda air

Batas masukan dan keluaran

Wan3.0 mendukung teks, frame pertama/terakhir, hingga 10 gambar referensi, 5 video referensi, 5 klip audio referensi, dan satu input file atau halaman web. Outputnya adalah 480P, 720P, atau 1080P selama 2–30 detik atau pengaturan waktu otomatis -1. Bingkai pertama/terakhir, media referensi, file, dan halaman web merupakan alur kerja yang saling eksklusif yang dipilih oleh input.media[].type.

Contoh alur kerja yang terdokumentasi

Wan3.0 menggunakan satu amplop input/parameters untuk teks, panduan bingkai, media referensi, file, dan halaman web; alur kerja ini saling eksklusif.

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": "wan3.0-video-prime",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

Media referensi

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

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 video per detik. 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
wan3.0-video-prime	Model didokumentasikan di halaman ini.