Kling Avatar 2.0 API

About Kling Avatar 2.0

The Kling Avatar 2.0 API has one endpoint: send a portrait as image_url and audio as audio_url, and get back a video of the portrait speaking or singing it, as long as the audio up to about five minutes. It is a natural backend for narrated explainers, localised spokesperson videos and podcast clips.

Call it with the model name kling/avatar-2.0/talking-avatar on POST /jobs/createTask, from 7.68 credits per second ($0.077). New accounts get 30 free credits to try it in the Playground first.

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.

What to build with the Kling Avatar 2.0 API

• Localisation tools: one spokesperson portrait, a separate audio file per language.
• Narrated explainers where a text-to-speech step feeds audio_url.
• Music apps that turn a cover photo and a song into a performance clip.

Kling Avatar 2.0 parameter notes

• image_url and audio_url are both required; output length follows the audio.
• resolution is 720p or 1080p; 1080p costs twice as much per second.
• A short prompt sets mood and gestures; it does not change the face.
• Trim audio server-side before sending to control cost and length.

How Kling Avatar 2.0 API pricing adds up

Billed per second of the audio you send. A five minute narration is a sizeable charge, so quote long files first and cap upload length in your UI.

• resolution 720p, 5-second clip: 39 credits ($0.39) each, 3900 credits ($39.00) for 100 clips
• resolution 1080p, 5-second clip: 77 credits ($0.77) each, 7700 credits ($77.00) for 100 clips

Async jobs, webhooks and rate limits

Every Kling Avatar 2.0 request is asynchronous: createTask returns a taskId straight away, and the result arrives when the job finishes. Poll GET /jobs/recordInfo every few seconds, or pass a public https callBackUrl and verify the X-Webhook-Signature header (HMAC-SHA256 over taskId, timestamp and the body hash) before trusting the payload. Each account gets 1,000 write requests per 10 seconds; a 429 carries Retry-After. Send an Idempotency-Key with createTask so a retried request for kling/avatar-2.0/talking-avatar never runs or bills twice.

Common Kling Avatar 2.0 API errors

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