Channel
Flow
heygen-avatar-4:flowdefaultPrice
from $0.142857 / s
GetVibeAPITheme
Language
Video
Heygen Avatar 4 API — how to connect and pay
HeyGen Avatar IV — a talking avatar from one photo and your voice-over: lips, expression, gestures. Requires image_url with a clearly visible face and audio_url; the clip is as long as the audio (up to 5 minutes). talking_style: stable (calm) or expressive. 360p–1080p. Priced per second of output video.
Channel comparison
last 7 days
| Channel | Price |
|---|---|
Flow heygen-avatar-4:flowdefault | from $0.142857 / s |
Build the result you need
heygen-avatar-4:flowThis model only publishes its minimum price in the catalog.
Input: Image, AudioSome modes require you to attach: source image, audio track
What is Heygen Avatar 4
HeyGen Avatar IV — a talking avatar from one photo and your voice-over: lips, expression, gestures. Requires image_url with a clearly visible face and audio_url; the clip is as long as the audio (up to 5 minutes). talking_style: stable (calm) or expressive. 360p–1080p. Priced per second of output video.
Contract at a glance
- Input
- image, audio
- Output
- video
- Mode
- async (job + polling)
- Status polling
- every 3 s · up to 600 s
Strengths
- Pricing: per second
- Inputs: image, audio
- 5 configurable options
- One API key for media generation
Where it is used
- Social media clips
- Promos and title sequences
- Still-image animation
- Storyboards and animatics
API contract
Generation runs asynchronously: create a job, then poll its status until completion.
- Create job
- POST /api/media/generate
- Check status
- GET /api/media/jobs/{jobId}
- Input
- image, audio
- Output
- video
- Polling
- every 3 s · up to 600 s
- Authentication
- Authorization: Bearer sk-pv-…
Example request
Pass your key in the Bearer header. The API returns jobId for polling the status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"heygen-avatar-4:flow","opts":{"image_url":"https://example.com/image_url.png","audio_url":"https://example.com/audio_url.mp3","resolution":"720p","aspect_ratio":"auto","talking_style":"stable"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "heygen-avatar-4:flow",
"opts": {
"image_url": "https://example.com/image_url.png",
"audio_url": "https://example.com/audio_url.mp3",
"resolution": "720p",
"aspect_ratio": "auto",
"talking_style": "stable"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API request parameters
Parameters for requests to Heygen Avatar 4 via the GetVibe API.
Parameter
image_urlType
URL
Values
Public image URL
Default
—
Price
—
Parameter
audio_urlType
URL
Values
Public audio URL
Default
—
Price
—
Parameter
resolutionType
option selection
Values
360p · 480p · 540p · 720p (default) · 1080p
Default
720p
Price
Included in the base price
Parameter
aspect_ratioType
option selection
Values
Match the photo (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1
Default
Match the photo
Price
Included in the base price
Parameter
talking_styleType
option selection
Values
Calm (default) · Expressive
Default
Calm
Price
Included in the base price
Parameter
image_file_idType
text
Values
Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…)
Default
—
Price
Included in the base price
Parameter
image_base64Type
text
Values
Alternative to image_url: the file inline, as base64 or a data: URI
Default
—
Price
Included in the base price
Parameter
audio_file_idType
text
Values
Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…)
Default
—
Price
Included in the base price
Parameter
audio_base64Type
text
Values
Alternative to audio_url: the file inline, as base64 or a data: URI
Default
—
Price
Included in the base price
| Parameter | Type | Values | Default | Price |
|---|---|---|---|---|
image_url | URL | Public image URL | — | — |
audio_url | URL | Public audio URL | — | — |
resolution | option selection | 360p · 480p · 540p · 720p (default) · 1080p | 720p | Included in the base price |
aspect_ratio | option selection | Match the photo (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1 | Match the photo | Included in the base price |
talking_style | option selection | Calm (default) · Expressive | Calm | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
audio_file_id | text | Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
audio_base64 | text | Alternative to audio_url: the file inline, as base64 or a data: URI | — | Included in the base price |
Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.
Price of Heygen Avatar 4
The cost of Heygen Avatar 4: from $0.142857 per second. The price is calculated dynamically at the current exchange rate, and the final charge is shown in the API response (priceRub). Payment in USD, no subscriptions.
What a default request costs
With no parameters sent, the request uses these values: Resolution — 720p, Frame format — Match the photo, Talking style — Calm. That request costs $0.142857.
Channels and prices for every parameter combination
For every channel, the price of every parameter combination. It is exactly the amount a successful generation is charged, and the same figure as in the machine-readable table linked below.
Flowheygen-avatar-4:flowfrom $0.142857 / sexact prices
| Price | Price |
|---|---|
| Flow | $0.142857 / s |
Price per second of the generated video. The charge is this price × the actual length of the result.
Every combination as JSON: /api/media/price-table?model=heygen-avatar-4%3Aflow
README
The machine-readable contract for Heygen Avatar 4 contains the request schema, operations, limits, polling and response examples.
# Heygen Avatar 4
Public model: heygen-avatar-4:flow
Create job: POST /api/media/generate
Check status: GET /api/media/jobs/{jobId}
## Input parameters
- `image_url` (URL): Public image URL; default: —
- `audio_url` (URL): Public audio URL; default: —
- `resolution` (option selection): 360p · 480p · 540p · 720p (default) · 1080p; default: 720p
- `aspect_ratio` (option selection): Match the photo (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1; default: Match the photo
- `talking_style` (option selection): Calm (default) · Expressive; default: Calm
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; default: —
- `audio_file_id` (text): Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `audio_base64` (text): Alternative to audio_url: the file inline, as base64 or a data: URI; default: —
## Public variants
- `heygen-avatar-4:flow`: FlowFAQ about the Heygen Avatar 4 API
How much does Heygen Avatar 4 cost?
The price of Heygen Avatar 4: from $0.142857 per second. The price is calculated dynamically at the current exchange rate.
Is it compatible with the OpenAI SDK?
Yes, the API is fully OpenAI-compatible. Just change base_url to https://getvibeapi.com/v1 and set your key — the rest of the code stays the same.
Connect Heygen Avatar 4 right now
Sign up in a minute, pay per use, ready-made code above.
Get API key