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.
| Field | Purpose | Accepted value |
|---|---|---|
image_url | Portrait to animate | Required, nonempty string; JPEG, PNG or WebP |
audio_url | Voice recording that supplies the speech | Required, nonempty string; up to 120 seconds |
prompt | Guidance for expression and movement | Optional; 1 to 2,000 characters when supplied |
resolution | Output height setting | 480p 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
| Parameter | Required | Description |
|---|---|---|
audio_url | Yes | The voice or music track to use. |
image_url | Yes | The picture to start from. |
prompt | No | Describe what you want to make. |
resolution | No | Choose 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.
| Option | USD 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
- 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.
- 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.
- 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.