Communitygithub.com

Aseel1600/Edit01

Générez des vidéos IA à partir de prompts textuels via plusieurs passerelles de fournisseurs. Utile pour : (1) Générer des vidéos à partir de descriptions textuelles, (2) Créer des clips vidéo générés par IA pour la production de contenu, (3) Génération vidéo à partir d'une image de référence, (4) Choisir entre les fournisseurs de génération vidéo (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Prend en charge les passerelles : API HeyGen, API fal.ai, API directe officielle Kling, et l'API Gemini (Gemini Omni Flash).

Qu'est-ce que Edit01 ?

Cette compétence permet de générer des vidéos à partir de prompts textuels et d'images de référence via une architecture multi-passerelles. Elle prend en charge les APIs HeyGen, fal.ai, Kling officiel et Gemini, donnant accès à des modèles comme Seedance 2.0, VEO, Kling, Sora, Runway et Gemini Omni. Utilisez le sélecteur `video_selector` pour choisir automatiquement la meilleure passerelle en fonction de la disponibilité, du coût et de la qualité. La compétence intègre également l'édition itérative avec Gemini Omni Flash et recommande Seedance 2.0 pour les travaux cinématiques grâce à son audio natif synchronisé, sa génération multi-plans, son contrôle caméra de niveau réalisateur et son classement Elo #1.

Compatible avec~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Aseel1600/Edit01/tree/HEAD/.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 prompts textuels. 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 vidéo Omni de basekling_official_video
API GeminiGEMINI_API_KEY / GOOGLE_API_KEYGemini Omni Flash (génération + édition conversationnelle)gemini_omni_video

Édition itérative — Gemini Omni. Lorsque le brief demande d'affiner un clip existant (ajouter/supprimer des objets, restyler, changer l'éclairage ou le texte à l'écran) plutôt que de le régénérer, Gemini Omni Flash est le seul fournisseur de la flotte avec une édition multi-tours stateful. Voir le Calque 3 gemini-omni pour le guide de prompting officiel (balises d'image de référence, syntaxe de timecode, règles de prompt d'édition) avant d'écrire un prompt.

Par défaut premium préféré — Seedance 2.0. Lorsqu'une passerelle premium est configurée (FAL_KEY → seedance_video, ou le chemin Agent Vidéo / Avatars Shots de HeyGen), Seedance 2.0 est le choix par défaut préféré pour les travaux cinématiques, de bande-annonce et de clips haute-fidélité. C'est le seul modèle de la flotte avec un audio natif synchronisé en un seul passage, une génération multi-plans, un contrôle caméra de niveau réalisateur et un lip-sync à partir de dialogues cités, et il est classé #1 sur l'Elo d'Artificial Analysis début 2026. Ne l'utilisez pas seulement lorsque 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 spécifique). Voir le Calque 3 seedance-2-0 pour le guide de prompting et de paramètres officiel.

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

Authentification

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

  • 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".
  • API Gemini : Définissez GEMINI_API_KEY ou GOOGLE_API_KEY pour accéder à la génération vidéo Gemini Omni et à l'édition conversationnelle.

Ne décrivez aucune passerelle comme étant la passerelle par défaut ou le meilleur choix sans d'abord vérifier 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é depuis 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 les 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-à-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, meilleure qualité)
VEO 3.1 Rapide"veo_3_1_fast"Variante VEO 3.1 plus rapide
VEO 3"veo3"Google VEO 3
VEO 3 Rapide"veo3_fast"Variante VEO 3 plus rapide
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-à-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-à-Vidéo

{
  "workflow_type": "GenerateVideoNode",
  "input": {
    "prompt": "Animer 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": "Un intérieur de 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 les détails d'ambiance
  2. Par défaut, choisissez 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-plans, lip-sync, caméra de niveau réalisateur. Utilisez VEO 3.1 / Sora V2 Pro lorsque l'utilisateur souhaite spécifiquement le personnage en mouvement de Google ou OpenAI ; utilisez ltx_distilled ou veo3_fast uniquement lorsque la vitesse est la contrainte forte.
  3. Utilisez des images de référence pour la génération image-à-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 des réseaux sociaux, 16:9 pour le paysage, 1:1 pour le carré.
  6. La sortie inclut asset_id — utilisez-la 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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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

Aseel1600/Edit01

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".

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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`).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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`.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Skills associés