Discussions
API Issues: Custom Avatar Background Not Applied & Nano Banana Avatar Not Found
Hello,
Issue 1: Background not applied to custom avatar
Avatar ID: b247014e114b4021ac44d995b1973b34
This avatar was created with the "Background Removal" option enabled. However, when I use it via API with background customization, the background is not applied. The video is generated with the original green screen background instead of the specified custom background.
Example API request:
{
"video_inputs": [
{
"character": {
"type": "avatar",
"avatar_id": "b247014e114b4021ac44d995b1973b34",
"avatar_style": "normal"
},
"voice": {
"type": "text",
"input_text": "Hello! This is a test video with custom background.",
"voice_id": "8abcca8159fe40e58f2cc4875b253091"
},
"background": {
"type": "image",
"image_asset_id": "ec823df3abae41cc918795489ace1c5e",
"fit": "cover"
}
}
],
"dimension": {
"width": 1280,
"height": 720
}
}
Generated video ID: 4b8be24c584846bd808664c463be48fa
When I replace the avatar_id with a public avatar (e.g., Lina_Dress_Sitting_Side_public), the custom background works correctly. What is causing this issue with my custom avatar?
Issue 2: Avatar created with Nano Banana not accessible via API
Avatar ID: b468c68e53424674b7919a0df744fb6a
This avatar was created using the Nano Banana tool. When I try to use it in API requests, I receive the following error:
{
"data": null,
"error": {
"code": "avatar_not_found",
"message": "Avatar b468c68e53424674b7919a0df744fb6a not found or no longer available."
}
}
However, this avatar is visible in my HeyGen Studio dashboard and works fine when creating videos through the web interface.
Questions:
Are avatars created with Nano Banana supported for API usage?
If yes, what is the correct way to use them via API?
What is causing the "avatar_not_found" error for this avatar?
Thank you for your assistance!