Familles Wan et HappyHorse

Les modèles de génération vidéo d’Alibaba, au nombre de six, s’appellent via l’endpoint vidéo d’OfoxAI POST /v1/videos. Les tâches s’exécutent de façon asynchrone : la création d’une tâche renvoie un ID de tâche, qui sert ensuite à récupérer le résultat.

Quel modèle choisir

Les six modèles prennent en charge le texte-vers-vidéo et l’image-vers-vidéo, et peuvent générer une piste audio synchronisée (generate_audio vaut true par défaut). adaptive reprend le format de l’image d’entrée.

Le tableau ci-dessus correspond aux video_attributes renvoyés par la Models API ; en cas d’évolution des capacités d’un modèle, la réponse de l’API fait foi. La facturation se fait à la seconde, le coût réel étant donné par usage.video_cost dans le résultat de la tâche ; les prix figurent sur la page du modèle .

Exemples d’appel

Les exemples ci-dessous ne montrent que la requête de création de tâche. Le déroulement complet (interrogation du statut puis téléchargement du résultat) est décrit dans Video API · Démarrage rapide.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Un village sur l’eau du Jiangnan au petit matin, une barque passe lentement sous un pont de pierre",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "La personne de l’image se retourne et s’éloigne",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "Conserver le mouvement de caméra et transformer l’image en animation au lavis",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images et input_references ne peuvent pas être envoyés ensemble ; les envoyer ensemble renvoie 400 references_conflict.
• Si vous n’avez pas besoin de piste audio, passez "generate_audio": false.
• La description complète des champs figure dans Créer une tâche vidéo.

Différences avec les autres familles

• Pas d’annulation : une fois la tâche soumise en amont, DELETE /v1/videos/{id} renvoie 400 cancel_not_supported, et la tâche continue d’être générée et facturée. Vérifiez les paramètres avant de soumettre.
• Adresse de la vidéo : lors de nos tests, une tâche terminée ne renvoie que unsigned_urls (adresse temporaire Alibaba Cloud OSS), sans mirror_urls. L’adresse temporaire peut expirer au bout de 24 heures ; téléchargez et conservez la vidéo rapidement.
• Durées plus courtes : 2 secondes au minimum pour Wan, 3 secondes pour HappyHorse, contre 4 secondes pour les autres familles.

Supprimer le filigrane

Les paramètres propres aux modèles Alibaba passent par provider.options.dashscope :

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options n’est transmis qu’au fournisseur correspondant ; les autres fournisseurs ne le reçoivent pas. Les explications complètes figurent dans Routage des fournisseurs vidéo.

Erreurs courantes

Les codes d’erreur complets figurent dans Codes d’erreur de la Video API.

Documentation officielle

• Alibaba Cloud Model Studio · Documentation des services de modèles 
• OfoxAI · Créer une tâche vidéo

FAQ