HeyGen Video 1 Text to Video overview
HeyGen Video 1 Text to Video by HeyGen
HeyGen built Video 1 to generate scenes with synchronized picture, dialogue and sound effects in one pass. Text to video clips on this endpoint run from 5 to 30 seconds.
HeyGen Video 1 Text to Video specs
- Model ID
heygen/video-1-text-to-video- Developer
- HeyGen
- Input
- Text
- Output
- Video
- Endpoint
POST https://api.aimlapi.com/v2/video/generations
Brief the scene and its sound together
The model produces a new scene with its own sound from the prompt alone. The dialogue, ambience and effects come from the same text as the picture.
HeyGen recommends describing the scene, mood, camera angle and action in the prompt. Add the lines people speak and what the place sounds like to the same brief. Then check that the generated audio matches what you wrote.
Settings that shape the result
Prompt enhancement sets how much HeyGen rewrites your prompt before generation. Ultraquality and disabled limit duration to 15 seconds. Turbo and quality leave the full range of 5 to 30 seconds open.
Aspect ratio runs from 21:9 to 9:16, so choose 9:16 for vertical clips and 16:9 or 21:9 for wide shots. Resolution offers 480p, 768p, 1080p and 2k. Start with quality enhancement at your target aspect ratio, then listen to the audio before you raise the duration.
Use cases
Generate vertical clips at 9:16 where a speaker delivers a line in a described setting.
Draft a scene of up to 30 seconds with turbo or quality enhancement to see how the action and dialogue play out.
Describe a camera angle, an action and the ambient sound to produce a product scene at 1080p or 2k.
Render a wide 21:9 establishing shot with ambience and effects written into the prompt.
HeyGen Video 1 Text to Video API pricing
| Usage | Price | Unit |
|---|---|---|
| Video generation | $0.01 | per second |
Prices from the AI/ML API price list, checked on Nov 12, 2026.
HeyGen Video 1 Text to Video vs other video models: prices
AI/ML API rates for 5 models, per second.
| Model | Per second |
|---|---|
 HeyGen Video 1 Text to Video | $0.01 |
 HunyuanVideo Foley | $0.01 |
 Kandinsky5 Text to Video Distill | $0.01 |
| Kandinsky5 Text to Video | $0.016 |
 MiniMax H3 Lite | $0.025 |
How to use the HeyGen Video 1 Text 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-text-to-video",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion"
}'import os
import requests
headers = {
"Authorization": f"Bearer {os.environ['AIMLAPI_KEY']}",
"Content-Type": "application/json",
}
payload = {
"model": "heygen/video-1-text-to-video",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion"
}
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-text-to-video",
"prompt": "A slow dolly shot through a sunlit greenhouse full of ferns, light dust in the air, natural camera motion"
}),
});
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 Text to Video
HeyGen Video 1 Text to Video FAQ
How much does HeyGen Video 1 Text to Video cost?
HeyGen Video 1 Text to Video costs $0.01 / sec on AI/ML API.
Does the generated video include audio?
Yes. The model generates dialogue, ambience and effects together with the picture from your text prompt.
How long can a clip be?
Duration can be set from 5 to 30 seconds. With ultraquality or disabled prompt enhancement, the limit is 15 seconds.
Which resolutions and aspect ratios are available?
Resolution can be 480p, 768p, 1080p or 2k. Aspect ratio can be 21:9, 16:9, 4:3, 1:1, 3:4 or 9:16.
What does prompt enhancement change?
It sets how much HeyGen rewrites your prompt before generation, using turbo, quality, ultraquality or disabled. Ultraquality and disabled also cap the clip at 15 seconds.
What is the HeyGen Video 1 Text to Video model ID?
Use heygen/video-1-text-to-video as the model parameter. Requests go to https://api.aimlapi.com/v2/video/generations with your AI/ML API key.