by HeyGen

A portrait speaks your recording for up to 10 minutes, with an optional new background

heygen/avatar-iv/talking-avatar
  • Up to 1080p
  • 5 aspect ratios
  • AI Avatar

About HeyGen Avatar IV

A portrait speaks your recording for up to 10 minutes, with an optional new background.

Call it with the model name heygen/avatar-iv/talking-avatar on POST /jobs/createTask, from $0.051.

Introduction

Send a clear, front-facing portrait in image_url and the speech recording in audio_url to animate the photographed speaker with HeyGen Avatar IV. Recordings may be up to 10 minutes long.

Key features

Set background_image_url when the speaker needs a different setting. Use expressiveness to choose low, medium, or high intensity; it starts at low. Choose among five resolution tiers spanning 360p–1080p at the same rate. For proportions, select 16:9, 9:16, 1:1, 5:4, or 4:5, or leave aspect_ratio empty to follow the photo.

In our tests, the potter delivered about 10 seconds of synchronized speech in a 720×900 clip. A separate recording showed the astronomer against a greenhouse replacement background with livelier movement at high expressiveness.

Request parameters

ParameterRequiredDescription
aspect_ratioNoThe shape of the frame: wide, square or tall. 16:9 · 9:16 · 1:1 · 5:4 · 4:5
audio_urlYesThe voice or music track to use.
background_image_urlNoOptional: a picture placed behind the person.
expressivenessNoHow much the face and head move: low (the default), medium or high. low · medium · high · Default: low
image_urlYesThe picture to start from.
promptNoDescribe what you want to make.
resolutionNoChoose an available output size. 360p · 480p · 540p · 720p · 1080p · Default: 720p

Pricing

Prices are in USD and charged to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

OptionUSD per second
Standard$0.051

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

Use the pottery workflow for a recorded craft explanation. Use a new background image to present a speaker in another location. Compare expression levels when choosing how animated a delivery should look.

Prompt guide & pro tips

Keep the words to be spoken in the supplied recording. Add an optional prompt for expression and gesture direction, as in the pottery example. The greenhouse example has no prompt and uses background_image_url plus high expressiveness instead.

Output resolution does not change that rate. Use authorized photos and voices only for yourself or for people who have agreed to this use.

API quick start

Call the HeyGen Avatar IV API in three steps

  1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls are billed in USD from your PopNow balance.
  2. Send the request. POST /jobs/createTask with model heygen/avatar-iv/talking-avatar and an input object that follows the parameter table. The response returns a task ID straight away.
  3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "heygen/avatar-iv/talking-avatar",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3",
    "expressiveness": "low",
    "resolution": "720p"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

HeyGen Avatar IV API questions

How much does the HeyGen Avatar IV API cost?

HeyGen Avatar IV costs $0.051 per second. API usage is charged in USD to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

What is the model name for HeyGen Avatar IV in the API?

Put heygen/avatar-iv/talking-avatar for AI Avatar in the model field of POST /jobs/createTask.

What do I send to HeyGen Avatar IV?

Provide a clear, front-facing portrait through image_url and a speech recording through audio_url; HeyGen returns a video of the photographed person speaking.

Can HeyGen replace the original setting?

Supply background_image_url with the new setting; our test put a rooftop astronomer in front of a greenhouse.

Which portrait proportions can I request?

The ratio choices are 16:9, 9:16, 1:1, 5:4, and 4:5; leaving aspect_ratio empty follows the supplied photo.

How much speech can a HeyGen recording contain?

The input speech can be up to 10 minutes long; the pottery recording in our tests was about 10 seconds.

What photo and voice rights do I need for HeyGen?

Use a photo and voice recording you have the right to use, and use the HeyGen clip only for yourself or for people who have agreed to this use.

What are the limits of the HeyGen Avatar IV API?

Resolutions: 360p · 480p · 540p · 720p · 1080p; Aspect ratios: 16:9 · 9:16 · 1:1 · 5:4 · 4:5; Prompt length (characters): 5,000; Largest upload: 50 MB. Requests outside these limits are rejected before anything is charged.

Can I try HeyGen Avatar IV without writing code?

Run HeyGen Avatar IV in the Playground with your API USD balance, without an API key. Each run appears in your developer history with its matching code.

All HeyGen models

More about HeyGen Avatar IV