Generate Transparent Avatar Videos in WebM Format

Effortless Transparent AI Avatar Video Creation

Welcome to Transparent Video Creation!

With the Konpro API, developers can easily create WebM videos featuring avatars that speak custom text, rendered with a transparent background for seamless overlay in any video or web project. This endpoint supports a curated set of studio avatars with flexible voice selection and customizable video dimensions.

Step 1: Retrieve Studio Avatars and Voices

To begin, obtain a list of available avatars and voices to configure your project.

List Avatars:

bash
curl --request GET \
     --url https://api.konpro.ai/v1/avatars \
     --header 'Accept: application/json' \
     --header 'x-api-key: <your-api-key>'

Select a studio avatar and note its avatar_id.

List Voices:

bash
curl --request GET \
     --url https://api.konpro.ai/v1/voices \
     --header 'Accept: application/json' \
     --header 'x-api-key: <your-api-key>'

Choose a voice_id that fits your needs.

Step 2: Generate a WebM Video with Transparent Background

Use the following API call to create a transparent video with your chosen avatar, voice, and script:

bash
curl -L 'https://api.konpro.ai/v1/video.webm' \
-H 'Content-Type: application/json' \
-H 'x-api-key: <your-api-key>' \
-d '{
  "avatar_pose_id": "<selected-avatar-id>",
  "avatar_style": "normal",
  "input_text": "Your custom script here.",
  "voice_id": "<selected-voice-id>"
}'

This will generate a new video task and return a video_id used for tracking progress.

Step 3: Monitor Video Generation

Track your video's status until processing completes:

bash
curl --request GET \
     --url https://api.konpro.ai/v1/video_status.get?video_id=<video_id> \
     --header 'Accept: application/json' \
     --header 'x-api-key: <your-api-key>'

When the status shows as completed, your WebM file (with transparent background) is ready for download. Note that the download URL will expire after seven days for security.

Table of Contents