Create Image/Avatar Videos

Generate dynamic videos for any project by choosing an avatar and a voice through the KonPro API

Create Image/Avatar Videos with KonPro

The KonPro API enables you to generate dynamic avatar videos with lifelike lip-sync, customizable voices, and expressive digital humans. Whether for education, entertainment, business, or storytelling, you can create engaging video content in just a few API calls.

Key Highlights

Wide Avatar Library

Choose from KonPro's collection of realistic digital humans.

Custom Voices

Select natural voices across multiple languages and accents.

Lip-Synced Video

AI ensures smooth mouth movement and expressions matching your text or audio.

Full Control

Adjust voice speed, pitch, tone, and avatar style.

Scalable API

Perfect for enterprise-scale content generation.

Step 1: Retrieve Avatars and Voices

Before creating a video, retrieve the list of available avatars and voices.

Avatars: Each has an ID, name, image_url, and type.
Voices: Each voice includes ID, language, gender, and style.

This ensures you select the right digital human and voice persona for your project.

bash

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

Tip: Save the avatar_id from the response for the next step.

bash

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

Choose a preferred voice_id.

Step 2: Generate Video

Once you've selected your avatar and voice, generate a video by combining them with text.

Input: Avatar ID, Voice ID, and your script text.
Customization: Adjust voice_speed (e.g., 0.9–1.2) and voice_pitch (e.g., -2 to +2).
Output: A video generation job is created with a unique job_id.

bash

curl -X POST 'https://api.konpro.ai/v1/video/generate' \
-H 'x-api-key: <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{
  "video_inputs": [
    {
      "character": {
        "type": "avatar",
        "avatar_id": "Lina_Dress_Sitting_Side_public",
        "avatar_style": "normal"
      },
      "voice": {
        "type": "text",
        "input_text": "Welcome to the Konpro API!",
        "voice_id": "119caed25533477ba63822d5d1552d25",
        "speed": 1.1
      }
    }
  ],
  "dimension": {
    "width": 1280,
    "height": 720
  }
}'

Ensure your input text is within platform character limits.

You can adjust the voice speed and pitch for extra personalization.

Step 3: Track Progress and Download

Video generation takes time depending on length and complexity.

Use the job_id to check the status.
Status values: processing, completed, or failed.
Once completed, you'll receive a download URL.
The download link is valid for 7 days.

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>'

Once status is completed, you'll receive a URL for the finished video.

bash

curl <video_url> --output output.mp4

The video download link is valid for seven days.

Best Practices for KonPro Video Creation

Optimize Text Length

Keep scripts short and natural (1–2 sentences per request). Long paragraphs reduce lip-sync precision.

Choose the Right Voice

Match tone and accent to your audience. Use formal voices for business, casual voices for storytelling.

Use Segmentation for Long Scripts

Break longer scripts into multiple segments and combine videos. Ensures smoother delivery and natural pauses.

Monitor Generation Status

Always confirm job status before fetching. Automate retries if status is processing.

Brand Customization

Use consistent avatars/voices to maintain identity. Adjust backgrounds, attire, and expressions if customization options are enabled.

Use Cases

Education & Training

Create digital instructors delivering lessons.

Business & Marketing

Produce video ads, product explainers, or personalized greetings.

Entertainment

Generate animated hosts, storytellers, or characters.

Customer Support

Deploy FAQ avatars that respond with video answers.

Corporate Communication

Announcements, onboarding, and compliance training videos.

Advanced Features in KonPro

•

Voice Cloning (optional)

Train avatars with your brand's voice.

•

Multi-language Support

Generate videos in 140+ languages and accents.

•

Custom Expressions

Adjust smiles, gestures, and emotional tone.

•

Batch Video Generation

Create multiple videos in a single request.

•

Integration Ready

Works with websites, apps, LMS platforms, and enterprise tools.

With KonPro's Avatar Video Creation API, you can go from text → lifelike video in minutes — unlocking a future where digital humans become your teachers, storytellers, and brand ambassadors.

Quick Start Customize Video Background

Create Image/Avatar Videos