Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
Create a speaking avatar with Kling Avatar 2.0 Standard, combining a character image and an audio performance with optional text direction.

Models

  • kwaivgi/kling-video/ai-avatar/v2/standard - Animate a character image with driving audio.

Features

  • Animate a character image with driving audio.
  • Accepts exactly 1 image in image_urls.

Duration Options

  • Driving audio: 2-60 seconds - The service detects the duration of audio_url.
  • The audio must be publicly reachable over HTTP(S) and no larger than 5 MiB.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials. Image inputs also accept image Data URIs or raw Base64. Image conversion and media validation complete before credits are deducted.

Image URLs

  • image_urls: Required. Supply exactly 1 item. Each item may be a public HTTP(S) URL, image Data URI, or raw Base64. Image order is preserved.

Audio URL

  • audio_url: Required. Provide the input audio URL. Use a publicly accessible HTTP(S) URL.

Prompt

  • prompt: Optional. Describe the scene and desired motion. Maximum 2500 characters after trimming.
  • Leading and trailing whitespace is trimmed. Omitted, null, empty, and whitespace-only values are treated as omitted.

Pricing

Usage is based on the detected driving-audio duration, rounded up to a whole second. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.

model
string
required
Example:

"kwaivgi/kling-video/ai-avatar/v2/standard"

input
object
required
callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required