ai-video-gen

Generate AI videos from text prompts. Supports multiple providers (VEO 3.1, Kling, Sora, Runway, Seedance), configurable aspect ratios, and optional reference images for image-to-video generation. All requests require the X-Api-Key header. Set the HEYGEN_API_KEY environment variable. POST GET - Call POST /v1/workflows/executions with workflow_type: "GenerateVideoNode" and your prompt - Receive a execution_id in the response - Poll GET /v1/workflows/executions/{id} every 10 seconds until status is completed - Use the returned video_url from the output - Be descriptive in prompts — include camera movement, lighting, style, and mood details - Default to VEO 3.1 for highest quality; use ltx_distilled or veo3_fast when speed matters - Use reference images for image-to-video generation — great for animating product photos or still images - Video generation is the slowest workflow — allow up to 5 minutes, poll every 10 seconds - Aspect ratio matters — use 9:16 for social media stories/reels, 16:9 for landscape, 1:1 for square - Output includes asset_id — use this to reference the generated video in other HeyGen workflows - Output URLs are temporary — download or save generated videos promptly