HeyGen Video 1 Image to Video overview
HeyGen Video 1 Image to Video by HeyGen
HeyGen Video 1 is HeyGen's generative video model. This endpoint animates one image, used as the first frame, into a clip with sound that follows your text prompt.
HeyGen Video 1 Image to Video specs
- Model ID
heygen/video-1-image-to-video- Developer
- HeyGen
- Input
- Image
- Output
- Video
- Endpoint
POST https://api.aimlapi.com/v2/video/generations
The image is the opening frame
HeyGen states that the supplied image is used as the literal first frame, so the video opens exactly as the still appears. Anything you want to see at the start has to be in the image already. The prompt only has to describe what happens next.
HeyGen also says image to video follows the proportions of the supplied image and does not require a fixed aspect ratio. Crop the image to the shape you want before you send it.
Settings that shape the clip
Duration accepts 5 to 30 seconds. Start at 5 seconds while you iterate on the prompt, then raise it once the motion looks right. Resolution accepts 480p, 768p, 1080p or 2k. Test at 480p and render the final clip at 1080p or 2k.
Prompt enhancement controls how much HeyGen rewrites your prompt before generation. The turbo and quality values keep the full duration range. The ultraquality and disabled values limit duration to 15 seconds. Start with quality, and switch to disabled only when you need the prompt followed as written, and the clip fits in 15 seconds.
Use cases
Animate a product photo into a short clip with sound for a landing page.
Turn an illustration or key visual into a moving opening shot for a social video.
Extend a still portrait into a 30 second clip with motion described in the prompt.
Compare 480p drafts against 2k renders of the same image before a final export.
HeyGen Video 1 Image to Video API pricing
| Usage | Price | Unit |
|---|---|---|
| Video generation | $0.01 |
Prices from the AI/ML API price list, checked on Nov 12, 2026.
How to use the HeyGen Video 1 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/video-1-image-to-video",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion",
"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/video-1-image-to-video",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion",
"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/video-1-image-to-video",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion",
"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 Video 1 Image to Video
HeyGen Video 1 Image to Video FAQ
How much does HeyGen Video 1 Image to Video cost?
HeyGen Video 1 Image to Video costs $0.01 / sec on AI/ML API.
Does the video start exactly on my image?
Yes. HeyGen states that the supplied image is used as the literal first frame, so the video opens exactly as the still appears.
How long can the video be?
Duration accepts 5 to 30 seconds. The ultraquality and disabled prompt enhancement values limit it to 15 seconds.
Do I need to set an aspect ratio?
No. HeyGen says image to video follows the proportions of the supplied image. Prepare the image in the shape you want.
What does prompt enhancement change?
It sets how much HeyGen rewrites your prompt before generation. The options are turbo, quality, ultraquality and disabled.
What is the HeyGen Video 1 Image to Video model ID?
Use heygen/video-1-image-to-video as the model parameter. Requests go to https://api.aimlapi.com/v2/video/generations with your AI/ML API key.