Customize Video Background
Customize your video backgrounds with API
Welcome to Background Customization!
With KonPro you can create videos with custom backgrounds. You can choose from Color, Image or Video sources as the background. To do this you need to change the "Background Settings" type to the appropriate option.
Background Types Available
1. Color Background
To select the background as color, you need change the background type to color. Then enter a color hex code in the value field.
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": "Brain_public_pro4_20230613",
"avatar_style": "normal"
},
"voice": {
"type": "text",
"input_text": "With KonPro, it is very easy to create avatar videos with custom backgrounds.",
"voice_id": "d7bbcdd6964c47bdaae26decade4a933"
},
"background": {
"type": "color",
"value": "#FAFAFA"
}
}
]
}'Tip:
You can also set the color code to #008000 if you want to create green screen videos.
2. Image Background
To select the background as image, you need change the background type to image. Then you need to provide either url for external image url or image_asset_id for image asset from KonPro.
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": "Brain_public_pro4_20230613",
"avatar_style": "normal"
},
"voice": {
"type": "text",
"input_text": "With KonPro, it is very easy to create avatar videos with custom backgrounds.",
"voice_id": "d7bbcdd6964c47bdaae26decade4a933"
},
"background": {
"type": "image",
"image_asset_id": "<asset_id>"
}
}
]
}'3. Video Background
To select the background as video, you need change the background type to video. Then you need to provide either url for external videos or video_asset_id for video assets from KonPro.
You can also specify video playback style with play_style. Supported values are fit_to_scene, freeze, loop, once.
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": "Brain_public_pro4_20230613",
"avatar_style": "normal"
},
"voice": {
"type": "text",
"input_text": "With KonPro, it is very easy to create avatar videos with custom backgrounds.",
"voice_id": "d7bbcdd6964c47bdaae26decade4a933"
},
"background": {
"type": "video",
"video_asset_id": "<asset_id>",
"play_style": "loop"
}
}
]
}'Conclusion
With KonPro's background customization API, you can create professional-looking videos with custom backgrounds that match your brand, content, or creative vision. Whether you need solid colors for clean presentations, custom images for branded content, or dynamic video backgrounds for engaging visuals, the API provides flexible options to enhance your video generation workflows.
Next Steps
Explore other video customization options like audio sources, personal avatars, and transparent video formats to create comprehensive video solutions.