Animate a person in an image with a script or your own audio. Nothing to set up first. The image needs a clearly visible, human-like face: a photo, or a realistic illustration of a person. An image with no detectable face returns 400.
For a whole scene from a prompt with the image as its first frame, use HeyGen Video with
mode: "image_to_video". It is also the route for mascots, animals and stylized or cartoon characters.
Create the video
- Image: a public URL, or
{ "type": "asset_id", "asset_id": "..." }after uploading it. - Speech:
scriptwith avoice_id(browse voices), oraudio_url/audio_asset_idto lip-sync your own recording. - Motion:
motion_promptdirects gestures;expressivenesstakeslow(default),mediumorhigh.
GET /v3/videos/{video_id} until status is completed, then download video_url. All other fields are in the API reference.
Talking Photo or Photo Avatar
Use Talking Photo for one-off videos. To reuse the same person across many videos, create a Photo Avatar once and pass itsavatar_id.
