# Kling Avatar

> Run Kling Avatar by klingai online or via API. $0.056/sec (std) or $0.112/sec (pro), no setup.

**URL:** https://inference.sh/apps/klingai/avatar
**Last updated:** 2026-09-21

---

Kling Avatar - generate digital human broadcast-style talking head videos from a single face photo. Provide text or audio for the avatar to speak.

- app: `klingai/avatar`
- maker: [klingai](https://inference.sh/apps/klingai.md)
- category: [video](https://inference.sh/apps/category/video.md)
- tasks: [talking avatar](https://inference.sh/apps/tag/talking-avatar.md)
- price: $0.056/sec (std) or $0.112/sec (pro)
- runs via: api, javascript and python sdk, belt cli, mcp

## avatar API Guide

### About
kling avatar - generate digital human broadcast-style talking head videos from a single face photo. provide text or audio for the avatar to speak.

### 1. Calling the API

#### Install the Client

```bash
pip install inferencesh
```

#### Setup Your API Key
Set `INFERENCE_API_KEY` as an environment variable. Get your key from settings → api keys.

```bash
export INFERENCE_API_KEY="inf_your_key"
```

#### Run and Get Result

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


result = client.run({
        "app": "klingai/avatar@1ksnt8jd",
        "input": {
            "image": "https://example.com/file.png"
        }
    })

print(result["output"])
```

#### Stream Live Updates

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


## stream=True yields updates as they arrive
for update in client.run({
        "app": "klingai/avatar@1ksnt8jd",
        "input": {
            "image": "https://example.com/file.png"
        }
    }, stream=True):
    if update.get("progress"):
        print(f"progress: {update['progress']}%")
    if update.get("output"):
        print(f"output: {update['output']}")
```

### 2. Authentication
The API uses API keys for authentication. See the authentication docs for detailed setup instructions.

### 3. Files

#### Automatic Upload

```python
## local file paths are automatically uploaded
result = client.run({
    "app": "klingai/avatar@1ksnt8jd",
    "input": {
        "image": "/path/to/local/image.png",  # detected & uploaded
        "audio": "https://example.com/audio.mp3",  # url passed through
    }
})
```

#### Manual Upload

```python
## upload and get a hosted URL
file = client.files.upload("/path/to/file.png")
print(file.uri)  # https://cloud.inference.sh/...
```

### 4. Schema

#### Input
- **image** (string) *required*: Face image for the avatar. Single clear front-facing face, good lighting. Formats: jpg, jpeg, png. Max 10MB.
- **audio** (string): Audio file for the avatar to speak (mp3/wav/m4a/aac, max 5MB, 2-300s).
- **prompt** (string): Action/emotion prompt for the avatar. E.g. 'While talking, excitedly shaking head'. Max 2500 chars.
- **mode** (string): Quality mode. 'pro' for higher quality ($0.112/sec), 'std' for cheaper ($0.056/sec).
- **aspect_ratio** (string): Output video aspect ratio.

#### Output
- **video** (string): The generated avatar video.

## other video apps

- [VACE](https://inference.sh/apps/pruna/vace.md): $0.40/video
- [P-Video-Animate](https://inference.sh/apps/pruna/p-video-animate.md): $0.03/sec 720p, $0.06/sec 1080p
- [P-Video-Upscale](https://inference.sh/apps/pruna/p-video-upscale.md): Std: $0.01/sec 720p, $0.02 1080p, $0.04 2k, $0.08 4k; high fps 2x
- [P-Video-2-Pro-Avatar](https://inference.sh/apps/pruna/p-video-2-pro-avatar.md): $0.02/sec 480p, $0.04/sec 768p, $0.06/sec 1080p, $0.08/sec 2k, $0.12/sec 4k
- [P-Video-2-Pro-Reference](https://inference.sh/apps/pruna/p-video-2-pro-reference.md): Output: cost $0.015-$0.105/sec, speed $0.02-$0.115/sec. Ref video: $0.03-$0.06/sec. Ref img: $0.005/img. Ref audio: $0.0015-$0.0025/sec

## faq

### how much does Kling Avatar cost?

$0.056/sec (std) or $0.112/sec (pro). you pay per run from your inference shell credits. no subscription is required.

### how do I run Kling Avatar via api?

call klingai/avatar with the javascript or python sdk, the rest api, or `belt app run klingai/avatar` from a terminal. the api reference on this page lists every input.

### who makes Kling Avatar?

Kling Avatar is made by klingai and runs on inference shell. every klingai app is listed at https://inference.sh/apps/klingai.

### can my agent use Kling Avatar?

yes. agents call it as a tool through the inference shell mcp server (https://api.inference.sh/mcp), the belt cli or the sdk, and pay per run like you do.

### what are the alternatives to Kling Avatar?

other video apps on inference shell include VACE, P-Video-Animate, P-Video-Upscale, P-Video-2-Pro-Avatar. they run through the same api, so switching is a one-line change.