HeyGen Video Agent
HeyGen Video Agent is an AI video production model that generates complete, multi-scene videos from a single text prompt. It automates the full production pipeline — scriptwriting, avatar selection, shot planning, B-roll integration, motion graphics, captions, and editing — producing broadcast-ready videos with consistent branding. The agent supports customizable avatars, voice cloning, and iterative editing without full regeneration, enabling scalable video content creation for marketing, training, and social media.
API Reference
INTEGRATE
Complete technical specification for integration
Request Response
Examples 4
CODE
Ready-to-use code snippets for common workflows
Origami Space Museum Explainer
{
"taskType": "videoInference",
"taskUUID": "86e70d5b-f263-4e53-91ea-e82552155a19",
"model": "heygen:video-agent@0",
"positivePrompt": "Create a polished 45-second educational brand video about a fictional 'Origami Space Museum' opening for families and school groups. Use a warm, curious, intelligent tone. Feature a presenter avatar as the host in several scenes, speaking directly to camera, with clean on-screen captions and tasteful motion graphics. Structure the video in multiple scenes: 1) an energetic opening with the host introducing the museum, 2) B-roll of towering folded-paper planets, suspended paper satellites, and intricate paper astronaut suits in a grand gallery, 3) a section highlighting interactive exhibits where children learn how folds mirror engineering principles, 4) a fast-paced montage of exhibit labels, hands folding geometric paper modules, and animated diagrams showing how flat sheets become complex structures, 5) a closing invitation with date, location, and family-friendly call to action. Visual style: contemporary educational promo, bright but refined palette of cobalt, cream, brass, and coral, crisp lighting, cinematic transitions, subtle depth of field, upbeat soundtrack feel implied by editing rhythm. Keep branding cohesive and premium. Make the host confident, approachable, and articulate. Emphasize that the full video should feel professionally produced from one prompt, with seamless scriptwriting, scene planning, captions, B-roll integration, and final edit.",
"width": 1280,
"height": 720,
"duration": 45,
"inputs": {
"avatar": "Judy_ConfidentSpeaking_Front_public"
}
}{
"taskType": "videoInference",
"taskUUID": "86e70d5b-f263-4e53-91ea-e82552155a19",
"videoUUID": "e376860e-f194-4542-9ddf-169ea920bf8e",
"videoURL": "https://vm.runware.ai/video/os/a19d05/ws/5/vi/e376860e-f194-4542-9ddf-169ea920bf8e.mp4",
"cost": 1.4667
}Midnight Vinyl Listening Lounge
{
"taskType": "videoInference",
"taskUUID": "43c178fb-21ac-412f-bd55-41ff237dff22",
"model": "heygen:video-agent@0",
"positivePrompt": "Create a 45-second polished presenter-led video introducing a boutique vinyl subscription club called Needle & Note. Use the provided input image as the speaking avatar. Tone: warm, sophisticated, inviting, and contemporary. Structure the video as a short branded promo with multiple scenes: opening hook from the host, close-up lifestyle B-roll of records sliding from sleeves, a turntable spinning, hands placing an album on a shelf, stylish membership box details, on-screen bullet points for monthly curated picks, member perks, and surprise collector extras, then return to the host for a concise call to action. Visual style: moody listening room with walnut shelves, velvet chair, amber practical lights, record stacks, subtle floating text graphics, elegant lower thirds, clean captions, smooth edits, premium social ad finish. Keep branding cohesive with cream, burgundy, and brass accents. Make the host confident and natural, with clear speech pacing and energetic but refined delivery.",
"width": 1280,
"height": 720,
"duration": 45,
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/83a440ae-c93c-458f-b34e-ebbca07571a0.jpg"
}
}{
"taskType": "videoInference",
"taskUUID": "43c178fb-21ac-412f-bd55-41ff237dff22",
"videoUUID": "0dca7e78-989f-47e6-9940-03e6870a53ea",
"videoURL": "https://vm.runware.ai/video/os/a22d05/ws/5/vi/0dca7e78-989f-47e6-9940-03e6870a53ea.mp4",
"cost": 1.1489
}Art Deco Jewelry Atelier
{
"taskType": "videoInference",
"taskUUID": "2f01f65c-c0bb-498f-aa6b-60bf7279f6bb",
"model": "heygen:video-agent@0",
"positivePrompt": "Create a 45-second premium brand video in 16:9 using the provided image as the speaking presenter avatar. Theme: a boutique jewelry house introducing a new collection inspired by Art Deco geometry and modern craftsmanship. Structure the video as a complete polished production with scriptwriting, scene changes, tasteful lower-thirds, animated title cards, captions, B-roll inserts, and seamless editing. Open with an elegant intro frame in a refined atelier interior with brass details, velvet trays, gemstone close-ups, and sketch illustrations. The presenter speaks directly to camera with poised, luxurious energy and clear marketing delivery. Include scenes showing macro shots of rings, necklaces, and earrings rotating on neutral backdrops; artisans sketching facets and setting stones; close views of tools, polished metal, and gemstone sparkle; branded graphic overlays highlighting design principles such as symmetry, craftsmanship, heirloom quality, and custom fitting. Use a warm, sophisticated color palette of emerald, cream, black, and brushed gold. Keep the pacing smooth and upscale, with subtle camera motion, soft depth of field, and premium commercial lighting. Add readable on-screen captions and tasteful motion graphics that feel suitable for social ads or a website hero video. End with a memorable call-to-action inviting viewers to book a private styling appointment and discover the collection.",
"width": 1280,
"height": 720,
"duration": 45,
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/db734229-9702-4029-bd38-4dc6c28a4779.jpg"
}
}{
"taskType": "videoInference",
"taskUUID": "2f01f65c-c0bb-498f-aa6b-60bf7279f6bb",
"videoUUID": "95f49fa8-40ec-4986-bbcc-a6d94e57a683",
"videoURL": "https://vm.runware.ai/video/os/a20d05/ws/5/vi/95f49fa8-40ec-4986-bbcc-a6d94e57a683.mp4",
"cost": 1.7524
}Retro Tech Product Showcase
{
"taskType": "videoInference",
"taskUUID": "d2c3787e-85bf-452e-80ea-b94baec35701",
"model": "heygen:video-agent@0",
"positivePrompt": "Create a sleek 30-second horizontal product-launch video in a retro-futuristic tech brand style. Use the provided image as the speaking avatar. The presenter introduces a fictional pocket device called 'PulseKey', a smart everyday gadget that organizes notes, payments, and travel access in one elegant object. Structure the video like a premium social ad with multiple scenes: an opening hero introduction with bold motion graphics, a presenter segment explaining the product benefit in clear concise language, stylish cutaway moments showing imagined close-ups of brushed metal surfaces, glowing interface details, and hands using the device in a modern apartment and night city setting, then a final call-to-action frame. Keep the editing energetic but polished, with confident startup-launch tone, vivid teal and warm amber accents, subtle film grain, clean captions, and smooth transitions. The avatar should remain natural, engaging, and centered when speaking, with the overall result feeling like a finished branded campaign video.",
"width": 1280,
"height": 720,
"duration": 30,
"inputs": {
"image": "https://assets.runware.ai/assets/inputs/0050d10b-8dc3-46c7-ba85-38b6da1ce559.jpg"
}
}{
"taskType": "videoInference",
"taskUUID": "d2c3787e-85bf-452e-80ea-b94baec35701",
"videoUUID": "3c619fc5-53bb-4106-a8c4-0a595f1fd62b",
"videoURL": "https://vm.runware.ai/video/os/a07d11/ws/5/vi/3c619fc5-53bb-4106-a8c4-0a595f1fd62b.mp4",
"cost": 0.758
}