API Wan 3.0

Referensi API lengkap untuk model pembuatan video Wan 3.0 dari Alibaba.

Varian Model

API ini mendukung empat varian model:

Perbandingan Singkat

Endpoint Bersama

Semua varian Wan 3.0 menggunakan endpoint tugas video:

POST /api/v1/video/task

Parameter Bersama

Wajib

Opsional

Wan 3.0 Teks ke Video

Atur model_name ke "wan-3.0-text-to-video" dan berikan parameter wajib bersama.

Contoh Permintaan

javascriptSalin
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'wan-3.0-text-to-video',
    prompt: 'A cinematic tracking shot follows a cyclist through a rain-soaked neon city at night',
    duration: 8,
    resolution: '1080p',
    aspect_ratio: '16:9',
    sound: true,
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Wan 3.0 Gambar ke Video

Input Gambar Wajib

Kedua gambar harus menggunakan format JPEG, JPG, PNG tanpa kanal alfa, BMP, atau WEBP. Setiap sisi gambar harus berukuran 240 hingga 8000 piksel.

Contoh Permintaan

javascriptSalin
{
  model_name: 'wan-3.0-image-to-video',
  prompt: 'The camera glides forward as daylight gradually shifts into a warm evening glow',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Pengeditan Video

Input Video Wajib

Durasi video sumber ditambah duration output yang diminta tidak boleh melebihi 30 detik.

Contoh Permintaan

javascriptSalin
{
  model_name: 'wan-3.0-video-edit',
  prompt: 'Turn the daytime scene into a rainy evening while preserving the subject and camera movement',
  video_url: 'https://example.com/source-video.mp4',
  duration: 10,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Referensi ke Video

Input referensi bersifat opsional dan dapat digabungkan, kecuali files dan links, yang tidak dapat dikirimkan bersamaan.

Input Referensi Opsional

Contoh Permintaan

javascriptSalin
{
  model_name: 'wan-3.0-reference-to-video',
  prompt: 'Use the references to create a cinematic product launch with coordinated motion and sound',
  duration: 12,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/product-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/sound-reference.mp3'],
  links: ['https://example.com/public-creative-brief'],
  seed: 42
}

Untuk menggunakan file referensi sebagai pengganti halaman web, hilangkan links dan berikan satu URL di files.

Format Respons

Respons Awal

Semua model mengembalikan task_id untuk polling:

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Respons Polling

Lakukan polling terhadap GET /api/v1/video/{taskId} untuk memeriksa status:

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Nilai Status

• submitted: Tugas diterima dan menunggu untuk diproses
• processing: Pembuatan video sedang berlangsung
• succeed: Pembuatan video selesai
• failed: Pembuatan video gagal

Praktik Terbaik

1. Arahan Prompt: Jelaskan subjek, tindakan, gerakan kamera, tempo, lingkungan, dan maksud suara dengan jelas.
2. Input Gambar: Gunakan gambar awal, akhir, dan referensi yang sesuai dengan rasio aspek yang diminta. Gambar PNG tidak boleh memiliki kanal alfa.
3. Waktu Pengeditan Video: Periksa durasi sumber sebelum memilih durasi output yang diminta agar totalnya tetap dalam batas 30 detik.
4. Batas Referensi: Validasi jumlah, format, dimensi, dan durasi gabungan setiap kumpulan referensi sebelum dikirim.
5. File dan Tautan: Kirim satu file referensi atau satu tautan halaman web publik, jangan pernah keduanya dalam permintaan yang sama.