by PopNow

A portrait speaks your recording at 480p or 720p, up to 2 minutes

popnow/talking-avatar-flash/talking-avatar
  • Up to 720p
  • AI Avatar

About Talking Avatar Flash

A portrait speaks your recording at 480p or 720p, up to 2 minutes.

Call it with the model name popnow/talking-avatar-flash/talking-avatar on POST /jobs/createTask, from $0.162.

Introduction

Give a portrait your recorded speech

Talking Avatar Flash animates a still portrait from a voice recording. Supply the image and audio, choose 480p or 720p, and add optional guidance for expression and movement. This workflow suits a course welcome, a presenter introduction or a product briefing whose spoken wording is already prepared.

The recording carries the speech. Treat the prompt as direction for the performance: how the face should look and how the head should move while the person speaks. Keeping those roles clear makes it easier to prepare the inputs and assess the returned video.

Prepare the portrait and audio

Provide a JPEG, PNG or WebP portrait in image_url and a voice recording in audio_url. Both fields require a nonempty value. The audio can be up to 120 seconds long, so check the complete file duration before submitting it.

Choose a portrait where you can clearly inspect the face. Listen to the recording from beginning to end and settle the wording, pauses and ending before generation. Remove an unwanted take or accidental silence while preparing the audio rather than trying to correct the spoken content through the movement prompt.

Input fields

Use the required pair of URLs for the source material, then set the optional fields according to the delivery and output height you want.

FieldPurposeAccepted value
image_urlPortrait to animateRequired, nonempty string; JPEG, PNG or WebP
audio_urlVoice recording that supplies the speechRequired, nonempty string; up to 120 seconds
promptGuidance for expression and movementOptional; 1 to 2,000 characters when supplied
resolutionOutput height setting480p or 720p; default 720p

Write direction you can review

Describe the expression and movement in a short, coherent instruction. For a welcome, you might ask for a friendly expression and steady head movement. For a briefing, a focused expression with small, measured movements gives you a different direction to assess. Match the instruction to the purpose of the recording.

Avoid filling the prompt with a second version of the script. If a product name, lesson detail or greeting needs to change, revise the audio before submitting the next request. Use the text field for the delivery you want to see while that recording plays.

When you do not need written direction, omit prompt. If you supply it, keep it within the 2,000-character limit and give it a nonempty value. To compare two directions, keep the portrait, recording and resolution unchanged and revise a specific expression or movement instruction. Save both prompts with their results so you can review the difference.

Our portrait-and-audio result

On November 18, 2026, our night-sky-talk run paired a portrait with a 9.2-second voice clip at the 480p setting. It returned a 556 x 740 MP4 lasting 9.38 seconds. The movement instruction was:

He speaks warmly with calm, natural head movement.

Open the example with sound to inspect how the speaking portrait presents the recording.

Review before sharing

Watch the completed clip alongside the source portrait and recording. Check the mouth movement against the speech, examine the expression during pauses, and listen through the ending. Consider whether the delivery fits its placement in your lesson, presentation or product briefing.

If you want to revise the delivery, identify a particular expression or movement to change. If the speech itself needs correction, prepare a revised recording. Keep the inputs, prompt and resolution with the result so the next request has a clear starting point.

Compare related talking-avatar options

Choose this endpoint when your task starts with a portrait and a prepared recording of up to 120 seconds, and its 480p or 720p settings fit your intended use. For another talking-avatar workflow, compare the pages for talking-avatar/v1 and infinitetalk/v1.

Request parameters

ParameterRequiredDescription
audio_urlYesThe voice or music track to use.
image_urlYesThe picture to start from.
promptNoDescribe what you want to make.
resolutionNoChoose an available output size. 480p · 720p · 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
resolution 480p$0.162
resolution 720p$0.324

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.

API quick start

Call the Talking Avatar Flash 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 popnow/talking-avatar-flash/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": "popnow/talking-avatar-flash/talking-avatar",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3",
    "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.

Talking Avatar Flash API questions

How much does the Talking Avatar Flash API cost?

Talking Avatar Flash costs $0.162 per second. Prices by option: 480p $0.162 per second, 720p $0.324 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 Talking Avatar Flash in the API?

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

What do I need to make a portrait speak?

Provide a portrait through image_url and a voice recording through audio_url. The portrait must be JPEG, PNG or WebP, and the recording can be up to 120 seconds long. You can also supply a prompt for expression and movement and choose between 480p and 720p.

Does the prompt contain the spoken script?

The audio recording supplies the speech. Use the optional prompt to guide expression and movement, such as a welcoming expression or calm head movement. Prepare the words in the recording before submitting the portrait and audio.

How long can my voice recording be?

Your voice recording can be up to 120 seconds long. Check its duration and listen through the complete take before submitting it, including any silence at the beginning or end.

Which portrait formats can I upload?

You can upload JPEG, PNG and WebP portraits. Choose a source where the face is easy to see, and compare the finished animation with that portrait during review.

What did your 480p example return?

Our November 18, 2026 run returned a 556 x 740 MP4 lasting 9.38 seconds. It paired a portrait with a 9.2-second voice recording, selected 480p and requested warm speech with calm, natural head movement.

What are the limits of the Talking Avatar Flash API?

Resolutions: 480p · 720p; Prompt length (characters): 2,000; Largest upload: 50 MB. Requests outside these limits are rejected before anything is charged.

Can I try Talking Avatar Flash without writing code?

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

All Talking Avatar models

More about Talking Avatar Flash