Kling Avatar 2.0 API

Introduction

Kling Avatar 2.0 Talking avatar takes a portrait (image_url) and an audio file of speech or song (audio_url) and returns a video of that person delivering the audio. The clip's length is set by the audio itself - there is no separate duration field - up to roughly 5 minutes. An optional prompt directs mood, gestures and where the eyes go, separately from what the audio says.

Key features

The audio sets the length

There is no duration parameter on this endpoint: trim your audio to the length you want the finished clip to run before you send it. Both speech and singing work as source audio.

The prompt directs the performance, the audio drives the words

prompt is optional and describes how the performance should feel - a mood, a gesture, where the eyes go - while audio_url supplies what is actually said or sung. Keeping the two separate is what let our test clips match delivered dialogue to the source audio word for word while still following a specific direction.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Give a script a face

Pair a recorded or generated line with a portrait to produce a spoken clip - useful for narrated intros, testimonials, or dialogue for a character whose face you've already settled on.

Direct a sung performance from a still photo

Send a sung audio track alongside a portrait and a short prompt describing the performance (audience, energy, a hand gesture) rather than the words themselves.

Prompt guide & pro tips

Write an arc, not a single mood

A direction like "glancing down once, then back into the lens with a shy laugh at the end" gives the avatar a small sequence to perform, rather than holding one static expression across the whole clip.

Choose a clear, front-facing portrait

A well-lit, front-facing photo gives the most reliable lip sync and expression. Side angles, obscured faces or extreme close-crops are more likely to drift as the clip runs.

Expect the clip to run a touch longer than the audio

In our tests the finished video consistently ran a little longer than the source audio - an 11.4-second line came back as a 12.27-second clip - so build in a small pad rather than expecting frame-exact timing at the very end.

Trim silence off both ends of the audio

A file that opens or closes on a long pause gives the avatar dead time with nothing to perform. Trim the audio close to where the speech or singing actually starts and ends before you send it.

API quick start

Call the Kling Avatar 2.0 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- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model kling/avatar-2.0/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": "kling/avatar-2.0/talking-avatar",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "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.

Kling Avatar 2.0 API questions

All Kling models

Kling 2.6 makes a full scene with camera movement and sound; Avatar 2.0 is for a fixed portrait that talks or sings.

• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip
• Kling 3.0 Turbo APIFaster Kling 3.0 with sound on every clipFrom 84 credits for a 5-second clip
• Kling Avatar 2.0 APIA portrait that speaks or sings your audio, up to 5 minutesFrom 7.68 credits per second
• Kling 2.6 API1080p clips with optional sound and motion controlFrom 52 credits for a 5-second clip
• Kling 2.5 Turbo API1080p clips with a soundtrack on every takeFrom 42 credits for a 5-second clip
• Kling 2.1 Master APISilent 1080p clips with fine prompt controlFrom 162 credits for a 5-second clip
• Kling 2.1 APIAnimate a frame at 720p or 1080p, with an optional end frameFrom 27 credits for a 5-second clip

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Talking Avatar APILip-synced talking video from a portrait and a voiceFrom 2.7 credits per second

More about Kling Avatar 2.0

Try it

Kling Avatar 2.0 AI Talking Avatar onlineCreate videos with Kling Avatar 2.0 in PopNow

Docs

Kling Avatar 2.0 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Kling Avatar 2.0 results without polling