> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Image to Video

> Animate a still image into video with the HeyGen Image to Video API — add motion, effects, and avatar-led narration.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research-8.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=d16cda8ab7835eed66c6a205d16e631f)

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`.

| | Talking Photo (this page) | [HeyGen Avatar 6](https://heygen-1fa696a7.mintlify.site/docs/models/avatar-6.md#model-api) |
| - | - | - |
| Endpoint | `POST /v3/videos` with `type: "image"` | `POST /v3/models/avatars` |
| Engine | Avatar IV | `heygen-avatar-6`, `heygen-avatar-6-turbo` |
| Speech | `script` + `voice_id`, or `audio_url` / `audio_asset_id` | `audio` |
| Resolution | `720p`, `1080p` | `1080p`, `2k` |

For a whole scene from a prompt with the image as its first frame, use [HeyGen Video](https://heygen-1fa696a7.mintlify.site/docs/models/heygen-video.md) with `mode: "image_to_video"`. It is also the route for mascots, animals and stylized or cartoon characters.

## Create the video

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/videos" \
  -H "x-api-key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "image": { "type": "url", "url": "https://example.com/person.jpg" },
    "script": "Hello! This video was generated directly from a photo.",
    "voice_id": "YOUR_VOICE_ID",
    "resolution": "1080p",
    "aspect_ratio": "auto"
  }'
```

* **Image**: a public URL, or `{ "type": "asset_id", "asset_id": "..." }` after [uploading](https://heygen-1fa696a7.mintlify.site/docs/upload-assets.md) it.
* **Speech**: `script` with a `voice_id` ([browse voices](https://heygen-1fa696a7.mintlify.site/docs/voices/overview.md)), 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}`](https://heygen-1fa696a7.mintlify.site/reference/get-video) until `status` is `completed`, then download `video_url`. All other fields are in the [API reference](https://heygen-1fa696a7.mintlify.site/reference/create-video.md).

## Talking Photo or Photo Avatar

Use Talking Photo for one-off videos. To reuse the same person across many videos, create a [Photo Avatar](https://heygen-1fa696a7.mintlify.site/photo-avatar.md) once and pass its `avatar_id`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.