coming-soon
MODEL IDheygen:video@1.0

HeyGen Video 1.0

HeyGen
by

HeyGen Video 1.0 is HeyGen's video generation model for short clips with synchronized audio. It generates the full frame from a text prompt, a first-frame image, or up to 12 image, video, and audio references, and produces dialogue, ambience, and sound effects in the same pass, with no separate lip-sync step. It outputs 5 to 15 second clips at 480p or 768p, suited to presenter shots, product and training content, and social video.

HeyGen Video 1.0

text-to-video

Volcanic Observatory Documentary Teaser
Try in Playground
import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'heygen:video@1.0',
  positivePrompt: 'Create a self-contained cinematic documentary title sequence in one continuous shot, composed for a 1344x768 landscape frame. Begin in an extreme macro view of a steel seismograph stylus scratching a thin black waveform onto slowly advancing cream paper. Fibers, ink bleed, screws, and vibration are sharply tactile. The camera glides backward just above the paper, following the newly drawn line as faint tremors make it quiver. Gradually reveal an empty, timeworn volcanic monitoring station: muted sage-green walls, analog gauges, paper charts, metal desks, coiled radio cables, amber task lamps, and moisture on a broad observation window. It is predawn, with cold cyan light outside and warm tungsten pools inside. Beyond the glass, a snow-streaked stratovolcano dominates the horizon beneath heavy charcoal clouds.\n\nAs the camera continues its slow, precise dolly backward, the tremor strengthens. Gauge needles twitch, a hanging metal lamp sways slightly, a ceramic mug ripples, and fine ceiling dust falls through the amber light. A narrow orange fissure opens near the volcano\'s summit, illuminating the underside of the clouds without becoming a huge explosive spectacle. The seismograph line in the foreground spikes violently. Settle into a centered, symmetrical wide composition with the moving seismograph paper low in the foreground and the volcano framed through the window. The room remains unoccupied, observational, credible, and grounded in real scientific detail.\n\nOver the darkened final composition, reveal the exact title “THE MOUNTAIN IS SPEAKING” in large, clean, condensed uppercase ivory lettering, centered and fully legible. Beneath it, add only the smaller line “A DOCUMENTARY SERIES”. Hold the final title steady for the closing beat with no other text, logos, captions, borders, or watermarks.\n\nArt direction: austere 1980s scientific realism, prestige natural-history documentary, restrained analogue texture, subtle 35mm film grain, gentle halation around practical lamps, deep blacks, sulfur-orange accents, cold blue dawn, controlled contrast, realistic scale and physics. Camera movement must remain smooth and deliberate with natural depth of field and no cuts, whip pans, or handheld shake.\n\nGenerate synchronized cinematic audio: close paper-feed mechanism, crisp stylus scratching, low electrical room hum, intermittent radio static, faint mountain wind against the window, gradually deepening subterranean rumble, soft glass and instrument-panel rattles, one restrained bowed-metal musical tone, then a sudden near-silence as the title settles. No speech, narration, crowd sounds, or dramatic trailer percussion.',
  width: 1344,
  height: 768
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "heygen:video@1.0",
            "positivePrompt": "Create a self-contained cinematic documentary title sequence in one continuous shot, composed for a 1344x768 landscape frame. Begin in an extreme macro view of a steel seismograph stylus scratching a thin black waveform onto slowly advancing cream paper. Fibers, ink bleed, screws, and vibration are sharply tactile. The camera glides backward just above the paper, following the newly drawn line as faint tremors make it quiver. Gradually reveal an empty, timeworn volcanic monitoring station: muted sage-green walls, analog gauges, paper charts, metal desks, coiled radio cables, amber task lamps, and moisture on a broad observation window. It is predawn, with cold cyan light outside and warm tungsten pools inside. Beyond the glass, a snow-streaked stratovolcano dominates the horizon beneath heavy charcoal clouds.\n\nAs the camera continues its slow, precise dolly backward, the tremor strengthens. Gauge needles twitch, a hanging metal lamp sways slightly, a ceramic mug ripples, and fine ceiling dust falls through the amber light. A narrow orange fissure opens near the volcano's summit, illuminating the underside of the clouds without becoming a huge explosive spectacle. The seismograph line in the foreground spikes violently. Settle into a centered, symmetrical wide composition with the moving seismograph paper low in the foreground and the volcano framed through the window. The room remains unoccupied, observational, credible, and grounded in real scientific detail.\n\nOver the darkened final composition, reveal the exact title “THE MOUNTAIN IS SPEAKING” in large, clean, condensed uppercase ivory lettering, centered and fully legible. Beneath it, add only the smaller line “A DOCUMENTARY SERIES”. Hold the final title steady for the closing beat with no other text, logos, captions, borders, or watermarks.\n\nArt direction: austere 1980s scientific realism, prestige natural-history documentary, restrained analogue texture, subtle 35mm film grain, gentle halation around practical lamps, deep blacks, sulfur-orange accents, cold blue dawn, controlled contrast, realistic scale and physics. Camera movement must remain smooth and deliberate with natural depth of field and no cuts, whip pans, or handheld shake.\n\nGenerate synchronized cinematic audio: close paper-feed mechanism, crisp stylus scratching, low electrical room hum, intermittent radio static, faint mountain wind against the window, gradually deepening subterranean rumble, soft glass and instrument-panel rattles, one restrained bowed-metal musical tone, then a sudden near-silence as the title settles. No speech, narration, crowd sounds, or dramatic trailer percussion.",
            "width": 1344,
            "height": 768
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "videoInference",
      "taskUUID": "61284338-3304-43e4-abb3-f49a7db02ca5",
      "model": "heygen:video@1.0",
      "positivePrompt": "Create a self-contained cinematic documentary title sequence in one continuous shot, composed for a 1344x768 landscape frame. Begin in an extreme macro view of a steel seismograph stylus scratching a thin black waveform onto slowly advancing cream paper. Fibers, ink bleed, screws, and vibration are sharply tactile. The camera glides backward just above the paper, following the newly drawn line as faint tremors make it quiver. Gradually reveal an empty, timeworn volcanic monitoring station: muted sage-green walls, analog gauges, paper charts, metal desks, coiled radio cables, amber task lamps, and moisture on a broad observation window. It is predawn, with cold cyan light outside and warm tungsten pools inside. Beyond the glass, a snow-streaked stratovolcano dominates the horizon beneath heavy charcoal clouds.\n\nAs the camera continues its slow, precise dolly backward, the tremor strengthens. Gauge needles twitch, a hanging metal lamp sways slightly, a ceramic mug ripples, and fine ceiling dust falls through the amber light. A narrow orange fissure opens near the volcano's summit, illuminating the underside of the clouds without becoming a huge explosive spectacle. The seismograph line in the foreground spikes violently. Settle into a centered, symmetrical wide composition with the moving seismograph paper low in the foreground and the volcano framed through the window. The room remains unoccupied, observational, credible, and grounded in real scientific detail.\n\nOver the darkened final composition, reveal the exact title “THE MOUNTAIN IS SPEAKING” in large, clean, condensed uppercase ivory lettering, centered and fully legible. Beneath it, add only the smaller line “A DOCUMENTARY SERIES”. Hold the final title steady for the closing beat with no other text, logos, captions, borders, or watermarks.\n\nArt direction: austere 1980s scientific realism, prestige natural-history documentary, restrained analogue texture, subtle 35mm film grain, gentle halation around practical lamps, deep blacks, sulfur-orange accents, cold blue dawn, controlled contrast, realistic scale and physics. Camera movement must remain smooth and deliberate with natural depth of field and no cuts, whip pans, or handheld shake.\n\nGenerate synchronized cinematic audio: close paper-feed mechanism, crisp stylus scratching, low electrical room hum, intermittent radio static, faint mountain wind against the window, gradually deepening subterranean rumble, soft glass and instrument-panel rattles, one restrained bowed-metal musical tone, then a sudden near-silence as the title settles. No speech, narration, crowd sounds, or dramatic trailer percussion.",
      "width": 1344,
      "height": 768
    }
  ]'
runware run heygen:video@1.0 \
  positivePrompt="Create a self-contained cinematic documentary title sequence in one continuous shot, composed for a 1344x768 landscape frame. Begin in an extreme macro view of a steel seismograph stylus scratching a thin black waveform onto slowly advancing cream paper. Fibers, ink bleed, screws, and vibration are sharply tactile. The camera glides backward just above the paper, following the newly drawn line as faint tremors make it quiver. Gradually reveal an empty, timeworn volcanic monitoring station: muted sage-green walls, analog gauges, paper charts, metal desks, coiled radio cables, amber task lamps, and moisture on a broad observation window. It is predawn, with cold cyan light outside and warm tungsten pools inside. Beyond the glass, a snow-streaked stratovolcano dominates the horizon beneath heavy charcoal clouds.

As the camera continues its slow, precise dolly backward, the tremor strengthens. Gauge needles twitch, a hanging metal lamp sways slightly, a ceramic mug ripples, and fine ceiling dust falls through the amber light. A narrow orange fissure opens near the volcano's summit, illuminating the underside of the clouds without becoming a huge explosive spectacle. The seismograph line in the foreground spikes violently. Settle into a centered, symmetrical wide composition with the moving seismograph paper low in the foreground and the volcano framed through the window. The room remains unoccupied, observational, credible, and grounded in real scientific detail.

Over the darkened final composition, reveal the exact title “THE MOUNTAIN IS SPEAKING” in large, clean, condensed uppercase ivory lettering, centered and fully legible. Beneath it, add only the smaller line “A DOCUMENTARY SERIES”. Hold the final title steady for the closing beat with no other text, logos, captions, borders, or watermarks.

Art direction: austere 1980s scientific realism, prestige natural-history documentary, restrained analogue texture, subtle 35mm film grain, gentle halation around practical lamps, deep blacks, sulfur-orange accents, cold blue dawn, controlled contrast, realistic scale and physics. Camera movement must remain smooth and deliberate with natural depth of field and no cuts, whip pans, or handheld shake.

Generate synchronized cinematic audio: close paper-feed mechanism, crisp stylus scratching, low electrical room hum, intermittent radio static, faint mountain wind against the window, gradually deepening subterranean rumble, soft glass and instrument-panel rattles, one restrained bowed-metal musical tone, then a sudden near-silence as the title settles. No speech, narration, crowd sounds, or dramatic trailer percussion." \
  width=1344 \
  height=768
{
  "taskType": "videoInference",
  "taskUUID": "61284338-3304-43e4-abb3-f49a7db02ca5",
  "model": "heygen:video@1.0",
  "positivePrompt": "Create a self-contained cinematic documentary title sequence in one continuous shot, composed for a 1344x768 landscape frame. Begin in an extreme macro view of a steel seismograph stylus scratching a thin black waveform onto slowly advancing cream paper. Fibers, ink bleed, screws, and vibration are sharply tactile. The camera glides backward just above the paper, following the newly drawn line as faint tremors make it quiver. Gradually reveal an empty, timeworn volcanic monitoring station: muted sage-green walls, analog gauges, paper charts, metal desks, coiled radio cables, amber task lamps, and moisture on a broad observation window. It is predawn, with cold cyan light outside and warm tungsten pools inside. Beyond the glass, a snow-streaked stratovolcano dominates the horizon beneath heavy charcoal clouds.\n\nAs the camera continues its slow, precise dolly backward, the tremor strengthens. Gauge needles twitch, a hanging metal lamp sways slightly, a ceramic mug ripples, and fine ceiling dust falls through the amber light. A narrow orange fissure opens near the volcano's summit, illuminating the underside of the clouds without becoming a huge explosive spectacle. The seismograph line in the foreground spikes violently. Settle into a centered, symmetrical wide composition with the moving seismograph paper low in the foreground and the volcano framed through the window. The room remains unoccupied, observational, credible, and grounded in real scientific detail.\n\nOver the darkened final composition, reveal the exact title “THE MOUNTAIN IS SPEAKING” in large, clean, condensed uppercase ivory lettering, centered and fully legible. Beneath it, add only the smaller line “A DOCUMENTARY SERIES”. Hold the final title steady for the closing beat with no other text, logos, captions, borders, or watermarks.\n\nArt direction: austere 1980s scientific realism, prestige natural-history documentary, restrained analogue texture, subtle 35mm film grain, gentle halation around practical lamps, deep blacks, sulfur-orange accents, cold blue dawn, controlled contrast, realistic scale and physics. Camera movement must remain smooth and deliberate with natural depth of field and no cuts, whip pans, or handheld shake.\n\nGenerate synchronized cinematic audio: close paper-feed mechanism, crisp stylus scratching, low electrical room hum, intermittent radio static, faint mountain wind against the window, gradually deepening subterranean rumble, soft glass and instrument-panel rattles, one restrained bowed-metal musical tone, then a sudden near-silence as the title settles. No speech, narration, crowd sounds, or dramatic trailer percussion.",
  "width": 1344,
  "height": 768
}
Response
{
  "taskType": "videoInference",
  "taskUUID": "61284338-3304-43e4-abb3-f49a7db02ca5",
  "videoUUID": "3f041ed5-28d8-48cb-82f0-9a8d09fb7056",
  "videoURL": "https://vm.runware.ai/video/os/a06dlim3/ws/5/vi/3f041ed5-28d8-48cb-82f0-9a8d09fb7056.mp4",
  "seed": 245386083
}

text-to-video

Equine Farrier Service Social Ad
Try in Playground
import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'heygen:video@1.0',
  positivePrompt: 'Create a premium landscape social media video ad for an independent mobile farrier service, grounded in authentic equestrian practice. Open on an extreme close-up of a skilled female farrier in a charcoal canvas apron drawing a rasp smoothly across the edge of a clean horse hoof; fine hoof shavings fall in crisp slow motion, with every stroke precisely synchronized to the gritty rasping sound. Hard cut to a medium eye-level shot inside an airy timber stable at cool early morning: the calm chestnut horse stands safely on three legs while the farrier lowers the freshly balanced hoof, runs a reassuring hand down the horse’s leg, then looks directly into camera. She says naturally with accurate lip synchronization: “Balanced feet make every stride feel better. Book your horse’s next trim today.” Cut on her final word to a low lateral tracking shot of the same horse walking comfortably beside its owner through the stable aisle, showing an even, relaxed stride. End on the horse’s confident hoof fall and a gentle tail swish. Refined documentary realism, tactile craftsmanship, slate blue shadows, warm chestnut and weathered oak, soft shafts of morning light, shallow depth of field, restrained handheld movement, clean editorial cuts. Authentic stable ambience throughout: quiet breathing, leather tack creaks, distant birds, soft hoofbeats, and subtle understated acoustic guitar beneath the dialogue. No captions, logos, watermarks, interface elements, exaggerated expressions, unsafe handling, or visible injuries.',
  width: 1344,
  height: 768
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "heygen:video@1.0",
            "positivePrompt": "Create a premium landscape social media video ad for an independent mobile farrier service, grounded in authentic equestrian practice. Open on an extreme close-up of a skilled female farrier in a charcoal canvas apron drawing a rasp smoothly across the edge of a clean horse hoof; fine hoof shavings fall in crisp slow motion, with every stroke precisely synchronized to the gritty rasping sound. Hard cut to a medium eye-level shot inside an airy timber stable at cool early morning: the calm chestnut horse stands safely on three legs while the farrier lowers the freshly balanced hoof, runs a reassuring hand down the horse’s leg, then looks directly into camera. She says naturally with accurate lip synchronization: “Balanced feet make every stride feel better. Book your horse’s next trim today.” Cut on her final word to a low lateral tracking shot of the same horse walking comfortably beside its owner through the stable aisle, showing an even, relaxed stride. End on the horse’s confident hoof fall and a gentle tail swish. Refined documentary realism, tactile craftsmanship, slate blue shadows, warm chestnut and weathered oak, soft shafts of morning light, shallow depth of field, restrained handheld movement, clean editorial cuts. Authentic stable ambience throughout: quiet breathing, leather tack creaks, distant birds, soft hoofbeats, and subtle understated acoustic guitar beneath the dialogue. No captions, logos, watermarks, interface elements, exaggerated expressions, unsafe handling, or visible injuries.",
            "width": 1344,
            "height": 768
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "videoInference",
      "taskUUID": "e7feb071-4dd3-4502-ab33-c010fc7c552d",
      "model": "heygen:video@1.0",
      "positivePrompt": "Create a premium landscape social media video ad for an independent mobile farrier service, grounded in authentic equestrian practice. Open on an extreme close-up of a skilled female farrier in a charcoal canvas apron drawing a rasp smoothly across the edge of a clean horse hoof; fine hoof shavings fall in crisp slow motion, with every stroke precisely synchronized to the gritty rasping sound. Hard cut to a medium eye-level shot inside an airy timber stable at cool early morning: the calm chestnut horse stands safely on three legs while the farrier lowers the freshly balanced hoof, runs a reassuring hand down the horse’s leg, then looks directly into camera. She says naturally with accurate lip synchronization: “Balanced feet make every stride feel better. Book your horse’s next trim today.” Cut on her final word to a low lateral tracking shot of the same horse walking comfortably beside its owner through the stable aisle, showing an even, relaxed stride. End on the horse’s confident hoof fall and a gentle tail swish. Refined documentary realism, tactile craftsmanship, slate blue shadows, warm chestnut and weathered oak, soft shafts of morning light, shallow depth of field, restrained handheld movement, clean editorial cuts. Authentic stable ambience throughout: quiet breathing, leather tack creaks, distant birds, soft hoofbeats, and subtle understated acoustic guitar beneath the dialogue. No captions, logos, watermarks, interface elements, exaggerated expressions, unsafe handling, or visible injuries.",
      "width": 1344,
      "height": 768
    }
  ]'
runware run heygen:video@1.0 \
  positivePrompt="Create a premium landscape social media video ad for an independent mobile farrier service, grounded in authentic equestrian practice. Open on an extreme close-up of a skilled female farrier in a charcoal canvas apron drawing a rasp smoothly across the edge of a clean horse hoof; fine hoof shavings fall in crisp slow motion, with every stroke precisely synchronized to the gritty rasping sound. Hard cut to a medium eye-level shot inside an airy timber stable at cool early morning: the calm chestnut horse stands safely on three legs while the farrier lowers the freshly balanced hoof, runs a reassuring hand down the horse’s leg, then looks directly into camera. She says naturally with accurate lip synchronization: “Balanced feet make every stride feel better. Book your horse’s next trim today.” Cut on her final word to a low lateral tracking shot of the same horse walking comfortably beside its owner through the stable aisle, showing an even, relaxed stride. End on the horse’s confident hoof fall and a gentle tail swish. Refined documentary realism, tactile craftsmanship, slate blue shadows, warm chestnut and weathered oak, soft shafts of morning light, shallow depth of field, restrained handheld movement, clean editorial cuts. Authentic stable ambience throughout: quiet breathing, leather tack creaks, distant birds, soft hoofbeats, and subtle understated acoustic guitar beneath the dialogue. No captions, logos, watermarks, interface elements, exaggerated expressions, unsafe handling, or visible injuries." \
  width=1344 \
  height=768
{
  "taskType": "videoInference",
  "taskUUID": "e7feb071-4dd3-4502-ab33-c010fc7c552d",
  "model": "heygen:video@1.0",
  "positivePrompt": "Create a premium landscape social media video ad for an independent mobile farrier service, grounded in authentic equestrian practice. Open on an extreme close-up of a skilled female farrier in a charcoal canvas apron drawing a rasp smoothly across the edge of a clean horse hoof; fine hoof shavings fall in crisp slow motion, with every stroke precisely synchronized to the gritty rasping sound. Hard cut to a medium eye-level shot inside an airy timber stable at cool early morning: the calm chestnut horse stands safely on three legs while the farrier lowers the freshly balanced hoof, runs a reassuring hand down the horse’s leg, then looks directly into camera. She says naturally with accurate lip synchronization: “Balanced feet make every stride feel better. Book your horse’s next trim today.” Cut on her final word to a low lateral tracking shot of the same horse walking comfortably beside its owner through the stable aisle, showing an even, relaxed stride. End on the horse’s confident hoof fall and a gentle tail swish. Refined documentary realism, tactile craftsmanship, slate blue shadows, warm chestnut and weathered oak, soft shafts of morning light, shallow depth of field, restrained handheld movement, clean editorial cuts. Authentic stable ambience throughout: quiet breathing, leather tack creaks, distant birds, soft hoofbeats, and subtle understated acoustic guitar beneath the dialogue. No captions, logos, watermarks, interface elements, exaggerated expressions, unsafe handling, or visible injuries.",
  "width": 1344,
  "height": 768
}
Response
{
  "taskType": "videoInference",
  "taskUUID": "e7feb071-4dd3-4502-ab33-c010fc7c552d",
  "videoUUID": "be949ba3-f305-48c0-bd2d-29143ef76e40",
  "videoURL": "https://vm.runware.ai/video/os/a06dlim3/ws/5/vi/be949ba3-f305-48c0-bd2d-29143ef76e40.mp4",
  "seed": 185153324
}

first-frame

Limited-Edition Welding Helmet Reel
Try in Playground
import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'heygen:video@1.0',
  positivePrompt: 'Continue directly and seamlessly from the supplied first frame as a premium vertical product showcase in one continuous shot. The metalworker maintains a poised editorial presence, slowly lowers the translucent amber visor with one gloved hand, then turns slightly toward the fabrication bench while keeping the sculptural helmet clearly visible. The camera makes a smooth, restrained push-in with a shallow 30-degree orbit around her upper body, revealing the hammered matte-black shell, curved side profile and amber visor from changing angles without altering the product design. She briefly activates the welding torch against a small steel plate already on the bench; a controlled blue-white arc creates elegant moving reflections across the visor and helmet contours, with a few realistic orange sparks falling safely downward. End on a confident three-quarter profile with the helmet dominating the frame. Preserve the same model, clothing, workshop, lighting direction and exact helmet construction throughout. Sophisticated industrial-fashion art direction, steel blue, charcoal and sodium orange palette, crisp premium detail, subtle atmospheric haze, realistic physical motion, no cuts, no scene change, no text, no logos, no additional people. Synchronized audio: a minimal percussive industrial-electronic pulse, quiet workshop room tone, the tactile click of the visor lowering and a brief authentic welding crackle; no speech.',
  resolution: '768p',
  inputs: {
    frameImages: [
      'https://assets.runware.ai/assets/inputs/cfb9a552-4dc1-45ca-8396-3441b6d538c8.jpg'
    ]
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "heygen:video@1.0",
            "positivePrompt": "Continue directly and seamlessly from the supplied first frame as a premium vertical product showcase in one continuous shot. The metalworker maintains a poised editorial presence, slowly lowers the translucent amber visor with one gloved hand, then turns slightly toward the fabrication bench while keeping the sculptural helmet clearly visible. The camera makes a smooth, restrained push-in with a shallow 30-degree orbit around her upper body, revealing the hammered matte-black shell, curved side profile and amber visor from changing angles without altering the product design. She briefly activates the welding torch against a small steel plate already on the bench; a controlled blue-white arc creates elegant moving reflections across the visor and helmet contours, with a few realistic orange sparks falling safely downward. End on a confident three-quarter profile with the helmet dominating the frame. Preserve the same model, clothing, workshop, lighting direction and exact helmet construction throughout. Sophisticated industrial-fashion art direction, steel blue, charcoal and sodium orange palette, crisp premium detail, subtle atmospheric haze, realistic physical motion, no cuts, no scene change, no text, no logos, no additional people. Synchronized audio: a minimal percussive industrial-electronic pulse, quiet workshop room tone, the tactile click of the visor lowering and a brief authentic welding crackle; no speech.",
            "resolution": "768p",
            "inputs": {
                "frameImages": [
                    "https://assets.runware.ai/assets/inputs/cfb9a552-4dc1-45ca-8396-3441b6d538c8.jpg"
                ]
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "videoInference",
      "taskUUID": "24b7beaf-7268-4c63-8878-a9a0a1c387d0",
      "model": "heygen:video@1.0",
      "positivePrompt": "Continue directly and seamlessly from the supplied first frame as a premium vertical product showcase in one continuous shot. The metalworker maintains a poised editorial presence, slowly lowers the translucent amber visor with one gloved hand, then turns slightly toward the fabrication bench while keeping the sculptural helmet clearly visible. The camera makes a smooth, restrained push-in with a shallow 30-degree orbit around her upper body, revealing the hammered matte-black shell, curved side profile and amber visor from changing angles without altering the product design. She briefly activates the welding torch against a small steel plate already on the bench; a controlled blue-white arc creates elegant moving reflections across the visor and helmet contours, with a few realistic orange sparks falling safely downward. End on a confident three-quarter profile with the helmet dominating the frame. Preserve the same model, clothing, workshop, lighting direction and exact helmet construction throughout. Sophisticated industrial-fashion art direction, steel blue, charcoal and sodium orange palette, crisp premium detail, subtle atmospheric haze, realistic physical motion, no cuts, no scene change, no text, no logos, no additional people. Synchronized audio: a minimal percussive industrial-electronic pulse, quiet workshop room tone, the tactile click of the visor lowering and a brief authentic welding crackle; no speech.",
      "resolution": "768p",
      "inputs": {
        "frameImages": [
          "https://assets.runware.ai/assets/inputs/cfb9a552-4dc1-45ca-8396-3441b6d538c8.jpg"
        ]
      }
    }
  ]'
runware run heygen:video@1.0 \
  positivePrompt="Continue directly and seamlessly from the supplied first frame as a premium vertical product showcase in one continuous shot. The metalworker maintains a poised editorial presence, slowly lowers the translucent amber visor with one gloved hand, then turns slightly toward the fabrication bench while keeping the sculptural helmet clearly visible. The camera makes a smooth, restrained push-in with a shallow 30-degree orbit around her upper body, revealing the hammered matte-black shell, curved side profile and amber visor from changing angles without altering the product design. She briefly activates the welding torch against a small steel plate already on the bench; a controlled blue-white arc creates elegant moving reflections across the visor and helmet contours, with a few realistic orange sparks falling safely downward. End on a confident three-quarter profile with the helmet dominating the frame. Preserve the same model, clothing, workshop, lighting direction and exact helmet construction throughout. Sophisticated industrial-fashion art direction, steel blue, charcoal and sodium orange palette, crisp premium detail, subtle atmospheric haze, realistic physical motion, no cuts, no scene change, no text, no logos, no additional people. Synchronized audio: a minimal percussive industrial-electronic pulse, quiet workshop room tone, the tactile click of the visor lowering and a brief authentic welding crackle; no speech." \
  resolution=768p \
  inputs.frameImages.0=https://assets.runware.ai/assets/inputs/cfb9a552-4dc1-45ca-8396-3441b6d538c8.jpg
{
  "taskType": "videoInference",
  "taskUUID": "24b7beaf-7268-4c63-8878-a9a0a1c387d0",
  "model": "heygen:video@1.0",
  "positivePrompt": "Continue directly and seamlessly from the supplied first frame as a premium vertical product showcase in one continuous shot. The metalworker maintains a poised editorial presence, slowly lowers the translucent amber visor with one gloved hand, then turns slightly toward the fabrication bench while keeping the sculptural helmet clearly visible. The camera makes a smooth, restrained push-in with a shallow 30-degree orbit around her upper body, revealing the hammered matte-black shell, curved side profile and amber visor from changing angles without altering the product design. She briefly activates the welding torch against a small steel plate already on the bench; a controlled blue-white arc creates elegant moving reflections across the visor and helmet contours, with a few realistic orange sparks falling safely downward. End on a confident three-quarter profile with the helmet dominating the frame. Preserve the same model, clothing, workshop, lighting direction and exact helmet construction throughout. Sophisticated industrial-fashion art direction, steel blue, charcoal and sodium orange palette, crisp premium detail, subtle atmospheric haze, realistic physical motion, no cuts, no scene change, no text, no logos, no additional people. Synchronized audio: a minimal percussive industrial-electronic pulse, quiet workshop room tone, the tactile click of the visor lowering and a brief authentic welding crackle; no speech.",
  "resolution": "768p",
  "inputs": {
    "frameImages": [
      "https://assets.runware.ai/assets/inputs/cfb9a552-4dc1-45ca-8396-3441b6d538c8.jpg"
    ]
  }
}
Response
{
  "taskType": "videoInference",
  "taskUUID": "24b7beaf-7268-4c63-8878-a9a0a1c387d0",
  "videoUUID": "12a0daaa-bfd9-4722-bc34-846fbcc53cf2",
  "videoURL": "https://vm.runware.ai/video/os/a04d20/ws/5/vi/12a0daaa-bfd9-4722-bc34-846fbcc53cf2.mp4",
  "seed": 51303045
}

reference-to-video

Municipal Archive Thriller Teaser
Try in Playground
import { createClient } from '@runware/sdk'

const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()

const [result] = await client.run({
  model: 'heygen:video@1.0',
  positivePrompt: 'Create a polished cinematic teaser and compact title sequence for a prestige conspiracy limited series called “THE QUIET LEDGER,” set inside a city’s flooded underground property archive. Compose in widescreen 16:9 for 768p. Use the reference image as the exact visual art-direction anchor: realistic water-damaged ledger paper, forensic ultraviolet glow, faded red municipal seals, oxidized teal shadows, restrained amber practical lights, steel shelving, damp institutional textures and elegant shallow-focus cinematography. Do not reproduce it as a static shot; build a coherent new sequence from its materials and atmosphere.\n\nUse the reference video as motion and camera-language guidance: the same patient forward dolly, subtle parallax through shelving, precise macro inserts, nearly imperceptible evidence-tag movement and controlled procedural suspense. Begin in near darkness as a filing drawer slides open by itself. Cut to extreme macro details: water crawling through paper fibers, parcel boundaries bleeding into one another, a steel date stamp descending, and a conservator’s black-gloved fingertip revealing erased handwriting beneath ultraviolet light. Transition through a match cut from a circular embossed seal to an overhead view of concentric water stains spreading across a city map. Finish on the open ledger at the end of the archive aisle as the camera slowly pushes closer and one previously blank line darkens as though hidden iron-gall ink is surfacing.\n\nSynchronize edits and physical actions to the supplied reference audio: paper taps motivate macro cuts, filing-drawer clicks motivate hard transitions, date-stamp impacts land on visual punctuation, and the low cello drone supports the continuous push into the archive. On the final deep impact, resolve to a stark, centered series title, “THE QUIET LEDGER,” in refined narrow ivory capitals subtly debossed into wet black paper; hold it cleanly while the room tone decays. No dialogue, no voice-over, no subtitles, no extra copy, no logos, no interface elements. Mood: intelligent institutional dread rather than horror, tactile and plausible, premium streaming-drama finish, restrained camera movement, natural material physics, coherent geography, crisp focal transitions and subtle 35mm grain.',
  resolution: '768p',
  inputs: {
    referenceImages: [
      'https://assets.runware.ai/assets/inputs/86a3f29a-924c-44a4-8b16-f0a3a3e83de1.jpg'
    ],
    referenceVideos: [
      'https://assets.runware.ai/assets/inputs/9495f060-3472-4c7a-b73a-024f70101d6c.mp4'
    ],
    referenceAudios: [
      'https://assets.runware.ai/assets/inputs/838cf2c9-b907-4da8-bf35-2366289a5a3e.mp3'
    ]
  }
})
import asyncio
import os

from runware import Runware


async def main():
    async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
        results = await client.run({
            "model": "heygen:video@1.0",
            "positivePrompt": "Create a polished cinematic teaser and compact title sequence for a prestige conspiracy limited series called “THE QUIET LEDGER,” set inside a city’s flooded underground property archive. Compose in widescreen 16:9 for 768p. Use the reference image as the exact visual art-direction anchor: realistic water-damaged ledger paper, forensic ultraviolet glow, faded red municipal seals, oxidized teal shadows, restrained amber practical lights, steel shelving, damp institutional textures and elegant shallow-focus cinematography. Do not reproduce it as a static shot; build a coherent new sequence from its materials and atmosphere.\n\nUse the reference video as motion and camera-language guidance: the same patient forward dolly, subtle parallax through shelving, precise macro inserts, nearly imperceptible evidence-tag movement and controlled procedural suspense. Begin in near darkness as a filing drawer slides open by itself. Cut to extreme macro details: water crawling through paper fibers, parcel boundaries bleeding into one another, a steel date stamp descending, and a conservator’s black-gloved fingertip revealing erased handwriting beneath ultraviolet light. Transition through a match cut from a circular embossed seal to an overhead view of concentric water stains spreading across a city map. Finish on the open ledger at the end of the archive aisle as the camera slowly pushes closer and one previously blank line darkens as though hidden iron-gall ink is surfacing.\n\nSynchronize edits and physical actions to the supplied reference audio: paper taps motivate macro cuts, filing-drawer clicks motivate hard transitions, date-stamp impacts land on visual punctuation, and the low cello drone supports the continuous push into the archive. On the final deep impact, resolve to a stark, centered series title, “THE QUIET LEDGER,” in refined narrow ivory capitals subtly debossed into wet black paper; hold it cleanly while the room tone decays. No dialogue, no voice-over, no subtitles, no extra copy, no logos, no interface elements. Mood: intelligent institutional dread rather than horror, tactile and plausible, premium streaming-drama finish, restrained camera movement, natural material physics, coherent geography, crisp focal transitions and subtle 35mm grain.",
            "resolution": "768p",
            "inputs": {
                "referenceImages": [
                    "https://assets.runware.ai/assets/inputs/86a3f29a-924c-44a4-8b16-f0a3a3e83de1.jpg"
                ],
                "referenceVideos": [
                    "https://assets.runware.ai/assets/inputs/9495f060-3472-4c7a-b73a-024f70101d6c.mp4"
                ],
                "referenceAudios": [
                    "https://assets.runware.ai/assets/inputs/838cf2c9-b907-4da8-bf35-2366289a5a3e.mp3"
                ]
            }
        })


asyncio.run(main())
curl https://api.runware.ai/v1 \
  -H "Authorization: Bearer $RUNWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "taskType": "videoInference",
      "taskUUID": "99ff99e3-19c4-4130-af1a-ceb48ae3a123",
      "model": "heygen:video@1.0",
      "positivePrompt": "Create a polished cinematic teaser and compact title sequence for a prestige conspiracy limited series called “THE QUIET LEDGER,” set inside a city’s flooded underground property archive. Compose in widescreen 16:9 for 768p. Use the reference image as the exact visual art-direction anchor: realistic water-damaged ledger paper, forensic ultraviolet glow, faded red municipal seals, oxidized teal shadows, restrained amber practical lights, steel shelving, damp institutional textures and elegant shallow-focus cinematography. Do not reproduce it as a static shot; build a coherent new sequence from its materials and atmosphere.\n\nUse the reference video as motion and camera-language guidance: the same patient forward dolly, subtle parallax through shelving, precise macro inserts, nearly imperceptible evidence-tag movement and controlled procedural suspense. Begin in near darkness as a filing drawer slides open by itself. Cut to extreme macro details: water crawling through paper fibers, parcel boundaries bleeding into one another, a steel date stamp descending, and a conservator’s black-gloved fingertip revealing erased handwriting beneath ultraviolet light. Transition through a match cut from a circular embossed seal to an overhead view of concentric water stains spreading across a city map. Finish on the open ledger at the end of the archive aisle as the camera slowly pushes closer and one previously blank line darkens as though hidden iron-gall ink is surfacing.\n\nSynchronize edits and physical actions to the supplied reference audio: paper taps motivate macro cuts, filing-drawer clicks motivate hard transitions, date-stamp impacts land on visual punctuation, and the low cello drone supports the continuous push into the archive. On the final deep impact, resolve to a stark, centered series title, “THE QUIET LEDGER,” in refined narrow ivory capitals subtly debossed into wet black paper; hold it cleanly while the room tone decays. No dialogue, no voice-over, no subtitles, no extra copy, no logos, no interface elements. Mood: intelligent institutional dread rather than horror, tactile and plausible, premium streaming-drama finish, restrained camera movement, natural material physics, coherent geography, crisp focal transitions and subtle 35mm grain.",
      "resolution": "768p",
      "inputs": {
        "referenceImages": [
          "https://assets.runware.ai/assets/inputs/86a3f29a-924c-44a4-8b16-f0a3a3e83de1.jpg"
        ],
        "referenceVideos": [
          "https://assets.runware.ai/assets/inputs/9495f060-3472-4c7a-b73a-024f70101d6c.mp4"
        ],
        "referenceAudios": [
          "https://assets.runware.ai/assets/inputs/838cf2c9-b907-4da8-bf35-2366289a5a3e.mp3"
        ]
      }
    }
  ]'
runware run heygen:video@1.0 \
  positivePrompt="Create a polished cinematic teaser and compact title sequence for a prestige conspiracy limited series called “THE QUIET LEDGER,” set inside a city’s flooded underground property archive. Compose in widescreen 16:9 for 768p. Use the reference image as the exact visual art-direction anchor: realistic water-damaged ledger paper, forensic ultraviolet glow, faded red municipal seals, oxidized teal shadows, restrained amber practical lights, steel shelving, damp institutional textures and elegant shallow-focus cinematography. Do not reproduce it as a static shot; build a coherent new sequence from its materials and atmosphere.

Use the reference video as motion and camera-language guidance: the same patient forward dolly, subtle parallax through shelving, precise macro inserts, nearly imperceptible evidence-tag movement and controlled procedural suspense. Begin in near darkness as a filing drawer slides open by itself. Cut to extreme macro details: water crawling through paper fibers, parcel boundaries bleeding into one another, a steel date stamp descending, and a conservator’s black-gloved fingertip revealing erased handwriting beneath ultraviolet light. Transition through a match cut from a circular embossed seal to an overhead view of concentric water stains spreading across a city map. Finish on the open ledger at the end of the archive aisle as the camera slowly pushes closer and one previously blank line darkens as though hidden iron-gall ink is surfacing.

Synchronize edits and physical actions to the supplied reference audio: paper taps motivate macro cuts, filing-drawer clicks motivate hard transitions, date-stamp impacts land on visual punctuation, and the low cello drone supports the continuous push into the archive. On the final deep impact, resolve to a stark, centered series title, “THE QUIET LEDGER,” in refined narrow ivory capitals subtly debossed into wet black paper; hold it cleanly while the room tone decays. No dialogue, no voice-over, no subtitles, no extra copy, no logos, no interface elements. Mood: intelligent institutional dread rather than horror, tactile and plausible, premium streaming-drama finish, restrained camera movement, natural material physics, coherent geography, crisp focal transitions and subtle 35mm grain." \
  resolution=768p \
  inputs.referenceImages.0=https://assets.runware.ai/assets/inputs/86a3f29a-924c-44a4-8b16-f0a3a3e83de1.jpg \
  inputs.referenceVideos.0=https://assets.runware.ai/assets/inputs/9495f060-3472-4c7a-b73a-024f70101d6c.mp4 \
  inputs.referenceAudios.0=https://assets.runware.ai/assets/inputs/838cf2c9-b907-4da8-bf35-2366289a5a3e.mp3
{
  "taskType": "videoInference",
  "taskUUID": "99ff99e3-19c4-4130-af1a-ceb48ae3a123",
  "model": "heygen:video@1.0",
  "positivePrompt": "Create a polished cinematic teaser and compact title sequence for a prestige conspiracy limited series called “THE QUIET LEDGER,” set inside a city’s flooded underground property archive. Compose in widescreen 16:9 for 768p. Use the reference image as the exact visual art-direction anchor: realistic water-damaged ledger paper, forensic ultraviolet glow, faded red municipal seals, oxidized teal shadows, restrained amber practical lights, steel shelving, damp institutional textures and elegant shallow-focus cinematography. Do not reproduce it as a static shot; build a coherent new sequence from its materials and atmosphere.\n\nUse the reference video as motion and camera-language guidance: the same patient forward dolly, subtle parallax through shelving, precise macro inserts, nearly imperceptible evidence-tag movement and controlled procedural suspense. Begin in near darkness as a filing drawer slides open by itself. Cut to extreme macro details: water crawling through paper fibers, parcel boundaries bleeding into one another, a steel date stamp descending, and a conservator’s black-gloved fingertip revealing erased handwriting beneath ultraviolet light. Transition through a match cut from a circular embossed seal to an overhead view of concentric water stains spreading across a city map. Finish on the open ledger at the end of the archive aisle as the camera slowly pushes closer and one previously blank line darkens as though hidden iron-gall ink is surfacing.\n\nSynchronize edits and physical actions to the supplied reference audio: paper taps motivate macro cuts, filing-drawer clicks motivate hard transitions, date-stamp impacts land on visual punctuation, and the low cello drone supports the continuous push into the archive. On the final deep impact, resolve to a stark, centered series title, “THE QUIET LEDGER,” in refined narrow ivory capitals subtly debossed into wet black paper; hold it cleanly while the room tone decays. No dialogue, no voice-over, no subtitles, no extra copy, no logos, no interface elements. Mood: intelligent institutional dread rather than horror, tactile and plausible, premium streaming-drama finish, restrained camera movement, natural material physics, coherent geography, crisp focal transitions and subtle 35mm grain.",
  "resolution": "768p",
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/86a3f29a-924c-44a4-8b16-f0a3a3e83de1.jpg"
    ],
    "referenceVideos": [
      "https://assets.runware.ai/assets/inputs/9495f060-3472-4c7a-b73a-024f70101d6c.mp4"
    ],
    "referenceAudios": [
      "https://assets.runware.ai/assets/inputs/838cf2c9-b907-4da8-bf35-2366289a5a3e.mp3"
    ]
  }
}
Response
{
  "taskType": "videoInference",
  "taskUUID": "99ff99e3-19c4-4130-af1a-ceb48ae3a123",
  "videoUUID": "d3eaf30b-10d6-4e81-b5ac-cb8ce7a8e6e9",
  "videoURL": "https://vm.runware.ai/video/os/a06dlim3/ws/5/vi/d3eaf30b-10d6-4e81-b5ac-cb8ce7a8e6e9.mp4",
  "seed": 2016507286
}