Communitygithub.com

9018/mychat

Générez des vidéos IA à partir de descriptions textuelles via plusieurs passerelles de fournisseurs. Utilisez-le pour : (1) générer des vidéos à partir de descriptions, (2) créer des clips vidéo IA pour la production de contenu, (3) générer des vidéos à partir d'une image de référence, (4) choisir entre différents fournisseurs de génération vidéo (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Passerelles supportées : API HeyGen, API fal.ai, API directe officielle Kling, et API Gemini (Gemini Omni Flash).

Qu'est-ce que mychat ?

Cette compétence permet de générer des vidéos par intelligence artificielle à partir d'un prompt textuel, en utilisant une architecture multi-fournisseurs. Elle est conçue pour les développeurs et les créateurs de contenu qui souhaitent produire des clips vidéo de haute qualité sans avoir à gérer directement les API de chaque fournisseur. La compétence prend en charge plusieurs passerelles : HeyGen, fal.ai, Kling Officiel et Gemini API, avec des outils dédiés pour des modèles comme Seedance 2.0 (recommandé pour le rendu cinématographique), Kling, MiniMax, VEO, Sora, et Runway. Un sélecteur vidéo intelligent (`video_selector`) choisit automatiquement le meilleur fournisseur en fonction de la disponibilité, du coût et de la qualité souhaitée, avec un biais pour Seedance 2.0 pour les contenus cinématiques. Enfin, Gemini Omni Flash permet l'édition itérative (modification d'objets, changement d'éclairage, etc.) en plusieurs tours de conversation.

Compatible avec~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.agents/skills/ai-video-gen

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Génération Vidéo (Multi-Passerelle)

Générez des vidéos IA à partir de descriptions textuelles. Prend en charge plusieurs fournisseurs via quatre chemins d'API :

PasserelleVariable d'EnvironnementFournisseursOutil
fal.aiFAL_KEYSeedance 2.0 (standard + rapide), Kling v3/v2.1, MiniMax, VEOseedance_video, kling_video, minimax_video, veo_video
HeyGenHEYGEN_API_KEYVEO 3.1, Kling Pro, Sora v2, Runway Gen-4, Seedance Pro / Lite (1.x)heygen_video
Kling OfficielKLING_API_KEYKling officiel Classic, Turbo, et Omni vidéo basiquekling_official_video
Gemini APIGEMINI_API_KEY / GOOGLE_API_KEYGemini Omni Flash (génération + édition conversationnelle)gemini_omni_video

Édition itérative — Gemini Omni. Lorsque le besoin est d'affiner un clip existant (ajout/suppression d'objets, restylage, modification de l'éclairage ou du texte à l'écran) plutôt que de regénérer, Gemini Omni Flash est le seul fournisseur de la flotte à permettre une édition multiturne avec état. Consultez le guide de prompt autorisé dans le Layer 3 gemini-omni (balises d'image de référence, syntaxe des timecodes, règles d'édition de prompt) avant d'écrire un prompt pour celui-ci.

Défaut premium préféré — Seedance 2.0. Lorsqu'une passerelle premium est configurée (FAL_KEY → seedance_video, ou le chemin Video Agent / Avatar Shots de HeyGen), Seedance 2.0 est le choix par défaut pour les travaux cinématiques, les bandes-annonces et les clips haute fidélité. C'est le seul modèle de la flotte proposant l'audio synchronisé natif en un seul passage, la génération multi-shots, le contrôle caméra de niveau réalisateur, et le lip-sync à partir de dialogues cités, et il se classe #1 sur l'Elo d'Artificial Analysis début 2026. Ne basculez que si l'utilisateur a une raison spécifique (budget, préférence de fournisseur, adéquation stylistique comme VEO pour les paysages photoréalistes ou Kling pour un look anime particulier). Voir le Layer 3 seedance-2-0 pour le guide autorisé de prompt et de paramètres.

IMPORTANT : Utilisez toujours video_selector au lieu d'appeler directement les outils fournisseurs. Le sélecteur gère les vérifications de disponibilité, la comparaison des coûts, et le repli automatique, et son moteur de scoring privilégie déjà Seedance 2.0 pour les intentions cinématiques.

Authentification

Utilisez la passerelle configurée qui correspond le mieux aux fournisseurs disponibles de l'utilisateur et à ses objectifs de coût/qualité.

  • HeyGen : Définissez HEYGEN_API_KEY pour accéder à la passerelle multi-modèle.
  • fal.ai : Définissez FAL_KEY pour accéder à Kling, MiniMax et Veo via fal.ai.
  • Kling Officiel : Définissez KLING_API_KEY pour accéder à l'API directe officielle de Kling via provider="kling_official".
  • Gemini API : Définissez GEMINI_API_KEY ou GOOGLE_API_KEY pour accéder à la génération de vidéo Gemini Omni et à l'édition conversationnelle.

Ne décrivez aucune passerelle comme étant le choix par défaut ou le meilleur sans avoir vérifié le registre et l'adéquation de la tâche actuelle.

fal.ai Kling (kling_video, provider="kling") et Kling Officiel (kling_official_video, provider="kling_official") sont des chemins différents. Ne réutilisez pas les URLs de file d'attente fal.ai, FAL_KEY, ou le comportement de téléchargement d'image lorsque le fournisseur officiel est sélectionné.

curl -X POST "https://api.heygen.com/v1/workflows/executions" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflow_type": "GenerateVideoNode", "input": {"prompt": "Un plan de drone survolant une ville côtière au coucher du soleil"}}'

Flux de Travail par Défaut

  1. Appelez POST /v1/workflows/executions avec workflow_type: "GenerateVideoNode" et votre prompt
  2. Recevez un execution_id dans la réponse
  3. Interrogez GET /v1/workflows/executions/{id} toutes les 10 secondes jusqu'à ce que le statut soit completed
  4. Utilisez le video_url retourné dans la sortie

Exécuter la Génération Vidéo

Point d'Accès

POST https://api.heygen.com/v1/workflows/executions

Champs de la Requête

ChampTypeReqDescription
workflow_typestringODoit être "GenerateVideoNode"
input.promptstringODescription textuelle de la vidéo à générer
input.providerstringFournisseur de génération vidéo (par défaut : "veo_3_1"). Voir Fournisseurs ci-dessous.
input.aspect_ratiostringRatio d'aspect (par défaut : "16:9"). Valeurs courantes : "16:9", "9:16", "1:1"
input.reference_image_urlstringURL de l'image de référence pour la génération image-vers-vidéo
input.tail_image_urlstringURL de l'image de fin pour le guidage de la dernière image
input.configobjectSurcharges de configuration spécifiques au fournisseur

Fournisseurs

FournisseurValeurDescription
VEO 3.1"veo_3_1"Google VEO 3.1 (par défaut, haute qualité)
VEO 3.1 Rapide"veo_3_1_fast"Variante plus rapide de VEO 3.1
VEO 3"veo3"Google VEO 3
VEO 3 Rapide"veo3_fast"Variante plus rapide de VEO 3
VEO 2"veo2"Google VEO 2
Kling Pro"kling_pro"Modèle Kling Pro
Kling V2"kling_v2"Modèle Kling V2
Sora V2"sora_v2"OpenAI Sora V2
Sora V2 Pro"sora_v2_pro"OpenAI Sora V2 Pro
Runway Gen-4"runway_gen4"Runway Gen-4
Seedance Lite"seedance_lite"Seedance Lite
Seedance Pro"seedance_pro"Seedance Pro
LTX Distillé"ltx_distilled"LTX Distillé (le plus rapide)

curl

curl -X POST "https://api.heygen.com/v1/workflows/executions" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_type": "GenerateVideoNode",
    "input": {
      "prompt": "Un plan de drone survolant une ville côtière à l'heure dorée, éclairage cinématographique",
      "provider": "veo_3_1",
      "aspect_ratio": "16:9"
    }
  }'

TypeScript

interface GenerateVideoInput {
  prompt: string;
  provider?: string;
  aspect_ratio?: string;
  reference_image_url?: string;
  tail_image_url?: string;
  config?: Record<string, any>;
}

interface ExecuteResponse {
  data: {
    execution_id: string;
    status: "submitted";
  };
}

async function generateVideo(input: GenerateVideoInput): Promise<string> {
  const response = await fetch("https://api.heygen.com/v1/workflows/executions", {
    method: "POST",
    headers: {
      "X-Api-Key": process.env.HEYGEN_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      workflow_type: "GenerateVideoNode",
      input,
    }),
  });

  const json: ExecuteResponse = await response.json();
  return json.data.execution_id;
}

Python

import requests
import os

def generate_video(
    prompt: str,
    provider: str = "veo_3_1",
    aspect_ratio: str = "16:9",
    reference_image_url: str | None = None,
    tail_image_url: str | None = None,
) -> str:
    payload = {
        "workflow_type": "GenerateVideoNode",
        "input": {
            "prompt": prompt,
            "provider": provider,
            "aspect_ratio": aspect_ratio,
        },
    }

    if reference_image_url:
        payload["input"]["reference_image_url"] = reference_image_url
    if tail_image_url:
        payload["input"]["tail_image_url"] = tail_image_url

    response = requests.post(
        "https://api.heygen.com/v1/workflows/executions",
        headers={
            "X-Api-Key": os.environ["HEYGEN_API_KEY"],
            "Content-Type": "application/json",
        },
        json=payload,
    )

    data = response.json()
    return data["data"]["execution_id"]

Format de Réponse

{
  "data": {
    "execution_id": "node-gw-v1d2e3o4",
    "status": "submitted"
  }
}

Vérifier le Statut

Point d'Accès

GET https://api.heygen.com/v1/workflows/executions/{execution_id}

curl

curl -X GET "https://api.heygen.com/v1/workflows/executions/node-gw-v1d2e3o4" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Format de Réponse (Terminé)

{
  "data": {
    "execution_id": "node-gw-v1d2e3o4",
    "status": "completed",
    "output": {
      "video": {
        "video_url": "https://resource.heygen.ai/generated/video.mp4",
        "video_id": "abc123"
      },
      "asset_id": "asset-xyz789"
    }
  }
}

Interrogation pour l'Achèvement

async function generateVideoAndWait(
  input: GenerateVideoInput,
  maxWaitMs = 600000,
  pollIntervalMs = 10000
): Promise<{ video_url: string; video_id: string; asset_id: string }> {
  const executionId = await generateVideo(input);
  console.log(`Génération vidéo soumise : ${executionId}`);

  const startTime = Date.now();
  while (Date.now() - startTime < maxWaitMs) {
    const response = await fetch(
      `https://api.heygen.com/v1/workflows/executions/${executionId}`,
      { headers: { "X-Api-Key": process.env.HEYGEN_API_KEY! } }
    );
    const { data } = await response.json();

    switch (data.status) {
      case "completed":
        return {
          video_url: data.output.video.video_url,
          video_id: data.output.video.video_id,
          asset_id: data.output.asset_id,
        };
      case "failed":
        throw new Error(data.error?.message || "La génération vidéo a échoué");
      case "not_found":
        throw new Error("Flux de travail non trouvé");
      default:
        await new Promise((r) => setTimeout(r, pollIntervalMs));
    }
  }

  throw new Error("La génération vidéo a expiré");
}

Exemples d'Utilisation

Texte-vers-Vidéo Simple

curl -X POST "https://api.heygen.com/v1/workflows/executions" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_type": "GenerateVideoNode",
    "input": {
      "prompt": "Une personne marchant dans un parc ensoleillé, faible profondeur de champ"
    }
  }'

Image-vers-Vidéo

{
  "workflow_type": "GenerateVideoNode",
  "input": {
    "prompt": "Animez cette photo de produit avec un zoom lent et des effets de particules doux",
    "reference_image_url": "https://example.com/product-photo.png",
    "provider": "kling_pro"
  }
}

Format Vertical pour les Réseaux Sociaux

{
  "workflow_type": "GenerateVideoNode",
  "input": {
    "prompt": "Intérieur d'un café branché, caméra panoramique lente sur le comptoir",
    "aspect_ratio": "9:16",
    "provider": "veo_3_1"
  }
}

Génération Rapide avec LTX

{
  "workflow_type": "GenerateVideoNode",
  "input": {
    "prompt": "Formes colorées abstraites qui se transforment et coulent",
    "provider": "ltx_distilled"
  }
}

Bonnes Pratiques

  1. Soyez descriptif dans les prompts — incluez les mouvements de caméra, l'éclairage, le style et l'ambiance
  2. Privilégiez Seedance 2.0 (via seedance_video) pour les travaux cinématiques et axés sur le mouvement lorsque FAL_KEY est défini — audio synchronisé en un seul passage, multi-shots, lip-sync, caméra de niveau réalisateur. Utilisez VEO 3.1 / Sora V2 Pro lorsque l'utilisateur souhaite spécifiquement le caractère de mouvement de Google ou OpenAI ; utilisez ltx_distilled ou veo3_fast uniquement lorsque la vitesse est une contrainte forte
  3. Utilisez des images de référence pour la génération image-vers-vidéo — idéal pour animer des photos de produits ou des images fixes
  4. La génération vidéo est le flux de travail le plus lent — prévoyez jusqu'à 5 minutes, interrogez toutes les 10 secondes
  5. Le ratio d'aspect est important — utilisez 9:16 pour les stories/reels sur les réseaux sociaux, 16:9 pour le paysage, 1:1 pour le carré
  6. La sortie inclut asset_id — utilisez-le pour référencer la vidéo générée dans d'autres flux de travail HeyGen
  7. Les URLs de sortie sont temporaires — téléchargez ou sauvegardez les vidéos générées rapidement

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

9018/mychat

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

9018/mychat

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

9018/mychat

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

9018/mychat

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

9018/mychat

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

9018/mychat

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

9018/mychat

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

9018/mychat

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

9018/mychat

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

9018/mychat

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

9018/mychat

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

9018/mychat

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

9018/mychat

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

9018/mychat

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

9018/mychat

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

9018/mychat

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

9018/mychat

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

Skills associés