​

Génération de vidéos

• generate pour les requêtes de génération texte-vers-vidéo sans média de référence
• imageToVideo lorsque la requête inclut une ou plusieurs images de référence
• videoToVideo lorsque la requête inclut une ou plusieurs vidéos de référence

​

Démarrage rapide

1. Définissez une clé API pour n’importe quel fournisseur pris en charge :

export GEMINI_API_KEY="your-key"

2. Épinglez éventuellement un modèle par défaut :

openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"

3. Demandez à l’agent :

Génère une vidéo cinématique de 5 secondes d’un homard amical faisant du surf au coucher du soleil.

​

Ce qui se passe lorsque vous générez une vidéo

1. OpenClaw envoie la requête au fournisseur et renvoie immédiatement un ID de tâche.
2. Le fournisseur traite la tâche en arrière-plan (généralement de 30 secondes à 5 minutes selon le fournisseur et la résolution).
3. Lorsque la vidéo est prête, OpenClaw réveille la même session avec un événement de fin interne.
4. L’agent publie la vidéo terminée dans la conversation d’origine.

​

Cycle de vie de la tâche

1. queued — tâche créée, en attente que le fournisseur l’accepte.
2. running — le fournisseur traite la requête (généralement de 30 secondes à 5 minutes selon le fournisseur et la résolution).
3. succeeded — vidéo prête ; l’agent se réveille et la publie dans la conversation.
4. failed — erreur du fournisseur ou expiration ; l’agent se réveille avec les détails de l’erreur.

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

Fournisseurs pris en charge

​

Matrice des capacités déclarées

​

Paramètres de l’outil

​

Obligatoire

​

Entrées de contenu

​

Contrôles de style

​

Avancé

• Aucun média de référence : generate
• Toute image de référence : imageToVideo
• Toute vidéo de référence : videoToVideo
• Les entrées audio de référence ne modifient pas le mode résolu ; elles s’appliquent par-dessus le mode sélectionné par les références image/vidéo, et ne fonctionnent qu’avec les fournisseurs qui déclarent maxInputAudios

​

Fallback et options typées

• Si le candidat actif ne déclare pas de maxInputAudios (ou le déclare à 0), il est ignoré lorsque la requête contient des références audio, et le candidat suivant est essayé.
• Si le maxDurationSeconds du candidat actif est inférieur au durationSeconds demandé et que le candidat ne déclare pas de liste supportedDurationSeconds, il est ignoré.
• Si la requête contient providerOptions et que le candidat actif déclare explicitement un schéma typé providerOptions, le candidat est ignoré lorsque les clés fournies ne figurent pas dans le schéma ou que les types de valeur ne correspondent pas. Les fournisseurs qui n’ont pas encore déclaré de schéma reçoivent les options telles quelles (transmission compatible avec l’existant). Un fournisseur peut explicitement refuser toutes les options de fournisseur en déclarant un schéma vide (capabilities.providerOptions: {}), ce qui provoque le même comportement d’ignorance qu’une incompatibilité de type.

​

Actions

• generate (par défaut) — crée une vidéo à partir de l’invite donnée et d’entrées de référence facultatives.
• status — vérifie l’état de la tâche vidéo en cours pour la session actuelle sans démarrer une autre génération.
• list — affiche les fournisseurs, modèles et leurs capacités disponibles.

​

Sélection du modèle

1. Paramètre d’outil model — si l’agent en spécifie un dans l’appel.
2. videoGenerationModel.primary — depuis la configuration.
3. videoGenerationModel.fallbacks — essayés dans l’ordre.
4. Détection automatique — utilise les fournisseurs qui ont une authentification valide, en commençant par le fournisseur par défaut actuel, puis les fournisseurs restants par ordre alphabétique.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
      },
    },
  },
}

​

Notes sur les fournisseurs

​

Modes de capacité des fournisseurs

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

Tests live

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

pnpm test:live:media video

• generate pour chaque fournisseur autre que FAL dans le balayage
• invite de homard d’une seconde
• plafond d’opération par fournisseur défini par OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 par défaut)

pnpm test:live:media video --video-providers fal

• imageToVideo lorsque capabilities.imageToVideo.enabled
• videoToVideo lorsque capabilities.videoToVideo.enabled et que le fournisseur/modèle accepte une entrée vidéo locale adossée à un buffer dans le balayage partagé

• runway uniquement lorsque vous sélectionnez runway/gen4_aleph

​

Configuration

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-r2v-flash"],
      },
    },
  },
}

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

​

Voir aussi

• Vue d’ensemble des outils
• Tâches en arrière-plan — suivi des tâches pour la génération vidéo asynchrone
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• Référence de configuration
• Modèles