HeyGen Image to Video overview
HeyGen Image to Video by HeyGen
HeyGen built this model to make the person in a still image speak. The speech comes from a written script or from audio you supply.
HeyGen Image to Video specs
- Model ID
heygen/image-to-video- Developer
- HeyGen
- Input
- Image
- Output
- Video
- Endpoint
POST https://api.aimlapi.com/v2/video/generations
Two ways to supply the speech
HeyGen describes two sources for what the person says. One is a script read with a selected voice. The other is the user's own audio.
In both cases the lips are synchronized to the speech. If you already have a recorded voice track, the own-audio route keeps that voice instead of generating one.
Settings to set before you generate
Aspect ratio accepts 16:9, 9:16, 1:1, 4:5, 5:4 or auto. Auto keeps the ratio of the source photo and falls back to 16:9 when the ratio cannot be read. Start with auto, then pick 9:16 or 1:1 when the video targets a specific feed.
Resolution is 720p or 1080p. HeyGen lists 1080p output for this model, so start there for final clips. Expressiveness is low, medium or high and sets the energy and range of facial and body movement. Start with medium, then compare low and high on the same photo and script.
Use cases
Turn a headshot and a written script into a spokesperson video for a product page.
Animate a portrait with a recorded voice track so the person appears to deliver the audio.
Produce vertical 9:16 talking clips from a single photo for short-form feeds.
Generate several takes of the same photo at different expressiveness levels to pick the most natural delivery.
HeyGen Image to Video API pricing
| Usage | Price | Unit |
|---|---|---|
| Video generation | $0.038 |
Prices from the AI/ML API price list, checked on Nov 12, 2026.
How to use the HeyGen Image to Video API
View docs
Build with your agent
Give your agent the model details, code and documentation.
1Get your API key
Create API keyexport AIMLAPI_KEY="8f2b4c7d9a1e6b3f…"2Make your first request
curl 'https://api.aimlapi.com/v2/video/generations' \
-H "Authorization: Bearer $AIMLAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "heygen/image-to-video",
"image_url": "https://example.com/input.jpg"
}'import os
import requests
headers = {
"Authorization": f"Bearer {os.environ['AIMLAPI_KEY']}",
"Content-Type": "application/json",
}
payload = {
"model": "heygen/image-to-video",
"image_url": "https://example.com/input.jpg"
}
response = requests.post("https://api.aimlapi.com/v2/video/generations", headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.aimlapi.com/v2/video/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "heygen/image-to-video",
"image_url": "https://example.com/input.jpg"
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());The request returns a generation id. Poll GET https://api.aimlapi.com/v2/video/generations?generation_id=<id> until the status is completed.
Models similar to HeyGen Image to Video
HeyGen Image to Video FAQ
How much does HeyGen Image to Video cost?
HeyGen Image to Video costs $0.038 on AI/ML API, billed as you go with no subscription.
What can drive the speech in the video?
A script or your own audio track. The lips are synchronized to whichever you use.
What does the auto aspect ratio do?
Auto keeps the aspect ratio of your source image. It uses 16:9 when the ratio cannot be read.
Which resolutions can I request?
720p or 1080p. HeyGen lists 1080p output for this model.
What does the expressiveness setting change?
It sets the energy and range of facial and body movement. The choices are low, medium and high.
What is the HeyGen Image to Video model ID?
Use heygen/image-to-video as the model parameter. Requests go to https://api.aimlapi.com/v2/video/generations with your AI/ML API key.