Create Avatar Videos Using Photo Avatars
How to create avatar video with Photo avatars.
Introduction
Using the JoggAI API, you can create videos with Photo Avatars. In this tutorial, we’ll guide you through making a video using your customized Photo Avatar and cloned Voice.
Core Concept: Asynchronous Processing Flow
Before you begin, it is crucial to understand that creating an avatar video is an asynchronous operation. This means you will not receive the final video file immediately after calling the API.
The entire process is as follows:
- Submit Task: Your application sends a
POST
request to Jogg.ai, containing the video script, selected avatar, and all other necessary information. - Receive Confirmation: The Jogg.ai server validates your request. If it’s valid, it will immediately return a
200 Accepted
response, which includes a uniqueproject_id
. This ID is your credential for tracking this task. - Background Processing: Your video creation task enters our processing queue. The server will render the video in the background based on the current workload. This process can take anywhere from a few seconds to several minutes.
- Retrieve Result: Once the video processing is complete, you can obtain the result in one of two ways:
- Webhook (Recommended): We will send a
POST
notification to your pre-configuredwebhook_url
, containing the video status and the final video playback address. This is the most efficient and reliable method. - Polling (Alternative): You can use the
project_id
to periodically call theGET /project/{project_id}
endpoint to check the task status.
- Webhook (Recommended): We will send a
Quick Start
Create Talking Avatar Video
First, create your Photo Avatar on the Create photo Avatar page. Then, use the
My Photo Avatars
List endpoint to obtain your Avatar ID, and theMy Voices List
endpoint to retrieve your Voice for video creation.
Please refer to the Create Talking Avatar Videos for more details and refer to the next section for obtaining the avatar_id and voice_id.
Here is a code example
Request Example:
Response example:
Get Avatars and Voices List
If you want to change the Avatar or voice, you can obtain the avatar_id
from My Photo Avatars List and the voice_id
from My Voices List to make replacements.
My Photo Avatars List
Please refer to the Get Photo Avatar List for more details.
Response example:
My Voices List
Please refer to the Get My Voice for more details.
Response example:
Get the generated video
Use the project_id obtained from the “Generate Video from Product Information” step to retrieve details about the video generation, including status and duration. Access the generated video using the video_url.
Please refer to the GetGeneratedVideo for the full options of enums.
Response example: