API Wan 3.0

Référence complète de l'API pour les modèles de génération vidéo Wan 3.0 d'Alibaba.

Variantes du modèle

Cette API prend en charge quatre variantes du modèle :

Comparaison rapide

Endpoint partagé

Toutes les variantes de Wan 3.0 utilisent l'endpoint de tâche vidéo :

POST /api/v1/video/task

Paramètres partagés

Requis

Facultatifs

Wan 3.0 Texte vers vidéo

Définissez model_name sur "wan-3.0-text-to-video" et fournissez les paramètres partagés requis.

Exemple de requête

javascriptCopier
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 Image vers vidéo

Images d'entrée requises

Les deux images doivent être au format JPEG, JPG, PNG sans canal alpha, BMP ou WEBP. Chaque côté de l'image doit mesurer entre 240 et 8 000 pixels.

Exemple de requête

javascriptCopier
{
  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 Édition vidéo

Vidéo d'entrée requise

La durée de la vidéo source additionnée à la duration du résultat demandé ne doit pas dépasser 30 secondes.

Exemple de requête

javascriptCopier
{
  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 Référence vers vidéo

Les entrées de référence sont facultatives et peuvent être combinées, à l'exception de files et links, qui ne peuvent pas être envoyés ensemble.

Entrées de référence facultatives

Exemple de requête

javascriptCopier
{
  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
}

Pour utiliser un fichier de référence à la place d'une page web, omettez links et transmettez une seule URL dans files.

Format de réponse

Réponse initiale

Tous les modèles renvoient un task_id pour les requêtes d'interrogation :

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

Réponse d'interrogation

Interrogez GET /api/v1/video/{taskId} pour vérifier l'état :

jsonCopier
{
  "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"
        }
      ]
    }
  }
}

Valeurs d'état

• submitted : tâche acceptée et en attente de traitement
• processing : génération vidéo en cours
• succeed : génération vidéo terminée
• failed : échec de la génération vidéo

Bonnes pratiques

1. Orientation du prompt : décrivez clairement les sujets, les actions, le mouvement de la caméra, le rythme, l'environnement et l'intention sonore.
2. Images d'entrée : utilisez des images de début, de fin et de référence correspondant au format d'image demandé. Les images PNG ne doivent pas contenir de canal alpha.
3. Durée de l'édition vidéo : vérifiez la durée de la source avant de choisir la durée demandée du résultat afin que leur total ne dépasse pas 30 secondes.
4. Limites des références : validez le nombre, le format, les dimensions et la durée cumulée de chaque collection de références avant l'envoi.
5. Fichiers et liens : envoyez soit un fichier de référence, soit un lien vers une page web publique, mais jamais les deux dans la même requête.