Skip to main content
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: script with a voice_id (browse voices), or audio_url / audio_asset_id to lip-sync your own recording.
  • Motion: motion_prompt directs gestures; expressiveness takes low (default), medium or high.
Poll 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 its avatar_id.