Generate Avatar IV Video

POSThttps://api.konpro.ai/v1/video/avatar_iv/generate

Create a high-quality Avatar IV video using a photo as input, enhanced with advanced AI-driven facial motion and expressive animations.

Request History

TIME	STATUS	USER AGENT
Make a request to see history.

0 Requests This Month

Request Body Parameters

Field	Type	Description
image_key	string	(Required) Asset key returned after uploading the source image via the Upload Asset API
video_title	string	(Required) Title assigned to the generated video
script	string	(Required) Text to be spoken by the avatar
voice_id	string	(Required) Voice ID selected from the KonPro voice library
video_orientation	string	Video aspect orientation: "portrait" (default) or "landscape"
fit	string	How the avatar fits within the frame. Options: "cover" or "contain"
custom_motion_prompt	string	Custom text prompt directing the avatar's motion style
enhance_custom_motion_prompt	boolean	Whether AI enhancement is applied to the custom motion prompt (default false)
audio_url	string	URL to an audio track to synchronize with the avatar speech
audio_asset_id	string	Alternatively, asset ID for the audio track uploaded to the system

Response

Returns HTTP 200 with the unique video ID and details upon successful creation.

Error codes and messages returned for invalid requests or failures.

cURL Request

shell

curl --request POST \
--url https://api.konpro.ai/v1/video/avatar_iv/generate \
--header "accept: application/json" \
--header "content-type: application/json" \
--header "x-api-key: <your-api-key>" \
--data '{
  "image_key": "img_abcdef123456",
  "video_title": "Product Demo Video",
  "script": "Welcome to our new product launch!",
  "voice_id": "voice789",
  "video_orientation": "portrait",
  "fit": "cover",
  "custom_motion_prompt": "expressive and lively",
  "enhance_custom_motion_prompt": true
}'

Example Usage

Shell

curl --request POST \
--url https://api.konpro.ai/v1/video/avatar_iv/generate \
--header "accept: application/json" \
--header "content-type: application/json" \
--header "x-api-key: <your-api-key>" \
--data '{
  "image_key": "img_abcdef123456",
  "video_title": "Product Demo Video",
  "script": "Welcome to our new product launch!",
  "voice_id": "voice789",
  "video_orientation": "portrait",
  "fit": "cover",
  "custom_motion_prompt": "expressive and lively",
  "enhance_custom_motion_prompt": true
}'

LANGUAGE

CREDENTIALS

Header

HEADER

RESPONSE

Examples

Choose an example:

application/json

200 - Result

400 - Result

Create a WebM Video Retrieve Sharable Video URL