Wan 2.7 API

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

Variantes de modèle

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

Comparaison rapide

Wan 2.7 Text to Video

Point de terminaison

POST /api/v1/video/task

Paramètres de requête

Obligatoire

Facultatif

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-2.7-text-to-video',
    prompt: 'A cat playing with a ball of yarn in a sunlit room',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    negative_prompt: 'blur, low quality',
    seed: 42
  })
});

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

Wan 2.7 Image to Video

Paramètres de requête

Obligatoire

Facultatif

Exemple de requête

javascriptCopier
{
  model_name: 'wan-2.7-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  video_url: 'https://example.com/reference-continuation.mp4',
  audio_url: 'https://example.com/driving-audio.mp3',
  prompt: 'Gentle camera push-in; leaves rustle softly in the breeze',
  duration: 6,
  resolution: '720p',
  negative_prompt: 'blur, low quality',
  seed: 42
}

Wan 2.7 Édition vidéo

Paramètres de requête

Obligatoire

Facultatif

Exemple de requête

javascriptCopier
{
  model_name: 'wan-2.7-video-edit',
  prompt: 'Replace the sky with warm sunset colors, keep subjects natural',
  negative_prompt: 'artifacts, flicker',
  seed: 42,
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/ref-a.jpg', 'https://example.com/ref-b.jpg'],
  audio_setting: 'auto'
}

Wan 2.7 Reference to Video

Générez une nouvelle vidéo à partir de références d’images et de vidéos ordonnées, avec un guidage vocal facultatif fourni par un clip audio.

Paramètres de requête

Obligatoire

Médias de référence

Au moins une image ou une vidéo de référence est requise. images et videos ne peuvent pas contenir plus de 5 éléments au total.

Facultatif

Espaces réservés de référence @ (AT)

La fonction de référence @ (AT) relie les médias de référence au prompt au moyen d’espaces réservés <<<...>>> numérotés. La numérotation commence à 1 indépendamment pour chaque type de média et suit l’ordre du tableau correspondant.

Exemple de requête

javascriptCopier
{
  model_name: 'wan-2.7-reference-to-video',
  prompt: 'Use image one for the hero and video one for the motion; keep the hero voice consistent with audio one',
  resolution: '1080p',
  duration: 8,
  aspect_ratio: '16:9',
  images: ['https://example.com/hero-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  negative_prompt: 'flicker, distorted hands, duplicate subjects',
  seed: 42
}

Exemple de requête Reference-to-Video avec @ (AT)

javascriptCopier
{
  model_name: 'wan-2.7-reference-to-video',
  prompt: 'Place the presenter from <<<image_1>>> in the studio from <<<image_2>>>, follow the camera path in <<<video_1>>>, and use the reference voice from <<<audio_1>>>',
  resolution: '1080p',
  duration: 8,
  aspect_ratio: '16:9',
  images: [
    'https://example.com/presenter-reference.jpg',
    'https://example.com/studio-reference.jpg'
  ],
  videos: ['https://example.com/camera-path-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  negative_prompt: 'flicker, distorted hands, duplicate subjects',
  seed: 42
}

Format de réponse

Réponse initiale

Tous les modèles renvoient un task_id pour le polling :

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 de polling

Interrogez GET /api/v1/video/{taskId} pour vérifier le statut :

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 de statut

• 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: La génération vidéo a échoué

Temps de traitement

Temps de traitement typique : 2 à 5 minutes selon la durée et les paramètres de résolution.

Les vidéos plus longues (10 à 15 secondes) en 1080p peuvent prendre jusqu’à 8 minutes.

Bonnes pratiques

1. Décrivez la scène et le mouvement : incluez à la fois le contenu de la scène et le mouvement de caméra dans les prompts
2. Choix de la résolution : utilisez 720p pour un traitement plus rapide, 1080p pour la meilleure qualité
3. Planification de la durée : les vidéos plus longues coûtent plus cher (tarification par seconde)
4. Intégration audio : ajoutez un audio personnalisé via le paramètre audio_url
5. Qualité d’image : pour l’image-to-video, utilisez des images d’entrée de haute qualité pour de meilleurs résultats
6. Prompts d’édition vidéo : soyez précis sur ce qu’il faut modifier et ce qu’il faut préserver
7. Nombre de ressources de référence : Pour Reference-to-Video, limitez à 5 le nombre total d’éléments dans images et videos
8. Voix de référence : Utilisez audios uniquement pour guider l’identité vocale et décrivez le contenu parlé souhaité dans le prompt