Video Generation

Kling Avatar API

Kling Avatar V2: turn a portrait plus an audio file into a talking avatar with audio-driven lip sync. Works on realistic humans, stylized characters, cartoons, and animals. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Audio

Credit Cost

2 credits/sec

Type

Video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/kling-avatar/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/kling-avatar.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`image` required	url	URL of the avatar reference image (.jpg/.jpeg/.png, ≤10MB, ≥300px, aspect ratio 1:2.5 to 2.5:1).	-
`audio` required	url	URL of the audio file that drives the avatar (.mp3/.wav/.m4a/.aac, ≤5MB). Determines output duration, and the charge: billed per second of this audio, measured server-side before the charge. A file that cannot be downloaded or measured, is not mp3/wav/m4a/aac, or is above 48 kHz or more than 2 channels, is refused with a 400 and not charged.	-
`prompt`	string	Optional text prompt to refine actions, emotions, and camera movement. Complements the audio.	-
`mode`	enum	Generation mode. "std" is the fast/standard tier at 2 credits per second of audio; "pro" yields sharper facial detail and smoother motion at 3.5 credits per second. `stdpro`	`std`

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Code Examples

Portrait + audio → talking avatar: copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/kling-avatar/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://...",
    "audio": "https://example.com/voice.mp3",
    "prompt": "a beauty blogger talking",
    "mode": "std"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 10,
  "creditsRemaining": 95,
  "expiresAt": "2026-11-16T17:22:20Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 10,
  "expiresAt": "2026-11-16T17:22:20Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits