Skip to main content
To bring your photo avatars to life, here’s a breakdown of the steps involved in uploading, generating, training LORA models, creating new looks, and adding motion for use in JoggAI videos:

​
Steps to Use the Photo Avatar API

  1. Upload Existing Photos or Generate New AI Avatar Photos: You can upload a set of your own photos or generate new AI photos.
  2. Create New Looks for the Avatar: You can use prompts to generate various “looks” for the avatar, such as different clothing, scenes, or poses. This is done within the trained Avatar Group, giving you diverse outputs.
  3. Add Motion Programmatically: You can enhance the avatars by adding dynamic motion programmatically. This includes enabling the avatar to move and adding audio to bring the avatar to life.
    a. Image Generation Charges:
    • Each call generates four images.
    • Each image deducts 0.05 credit.
    • Four images deduct a total of 0.2 credit.
    b. Motion Generation Charges:
    • Motion 1.0 deducts 2 credits.
    • Motion 2.0 deducts 2 credits.
    • Motion 2.0 Pro deducts 3 credits.
    • Motion 3.0 deducts 2 credits.

​
Conclusion

Once you’ve created the photo avatar and added motion , you can use these avatars in video generation. This makes it possible to integrate highly personalized, animated avatars into video content creation, enhancing the overall user experience.

​
Generate AI Avatar Photos

Learn how to create customized AI avatar photos using JoggAI’s API. These avatars can be personalized with attributes such as age, gender, ethnicity, pose, style, and appearance. Once generated, these avatars can be used to create new looks for further customization.

​
Generate AI Avatar Photo

See detailed API reference Use this endpoint to generate AI photo avatars with customizable attributes. The following attributes are required to define the avatar’s look: avatar_styleage, gender, ethnicity, appearance, background, model, aspect_ratio. 
curl --location 'https://api.jogg.ai/v1/photo_avatar/photo/generate' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>' \
--data '{
	"avatar_style": "social",
    "age": "Young Adult",
    "gender": "male",
    "ethnicity": "Asian",
    "appearance": "Medium-length curly bright red hair. Wearing a black satin top with a deep V-neckline, accessorized with gold earrings.",
    "background": "A vibrant living room with asymmetrical furniture in bold primary colors, a checkerboard floor, and a sculptural glass coffee table under a geometric pendant light.",
    "model": "classic",
    "aspect_ratio": 0
}'

{
    "rid": "9ee49c2f31204f76da8081ce0af28eae",
    "code": 0,
    "msg": "success",
    "data": {
        "photo_id": "25-1a0ab69d92b6449796d6e9ec0b993a3f"
    }
}

​
Check Generation Status

See detailed API reference Track the progress of your avatar photo generation using the following endpoint: 
curl --request GET \
     --url https://api.jogg.ai/v1/photo_avatar/generation?photo_id=4ea4fea89c724fcfb49502c4323bac55 \
     --header 'accept: application/json' \
     --header 'x-api-key: <your_api_key>'

{
    "rid": "663a1cbe962c90ed19f395c1f21a3d3c",
    "code": 0,
    "msg": "success",
    "data": {
        "photo_id": "25-7fca6bdc66c84767ba8a7ddb9bbb4d77",
        "status": "in_progress",
        "msg": null,
        "image_url_list": null,
        "image_key_list": null
    }
}

{
    "rid": "54a8387f7beb857d1f72f2abc421b4ec",
    "code": 123,
    "msg": "<string>",
    "data": {
        "photo_id": "def3076d2c8b4929acf269d8ea6b562e",
        "status": "error",
        "msg": null,
        "image_url_list": null,
        "image_key_list": null
    }
}

{
    "rid": "54a8387f7beb857d1f72f2abc421b4ec",
    "code": 0,
    "msg": "success",
    "data": {
        "photo_id": "25-1a0ab69d92b6449796d6e9ec0b993a3f",
        "status": "success",
        "msg": null,
        "image_url_list": [
            "https://res.jogg.ai/joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/bbb42ee5-8fa1-45b6-be47-105f97d2ca20.png",
            "https://res.jogg.ai/joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/7406e9b3-f1a7-4bae-9bb8-efed69b52bf4.png",
            "https://res.jogg.ai/joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/fd6a5880-9108-48d4-b501-afccec708378.png",
            "https://res.jogg.ai/joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/711bb2f6-ac1c-46bc-94c3-c0ce3a76cef9.png"
        ],
        "image_key_list": [
            "joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/bbb42ee5-8fa1-45b6-be47-105f97d2ca20.png",
            "joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/7406e9b3-f1a7-4bae-9bb8-efed69b52bf4.png",
            "joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/fd6a5880-9108-48d4-b501-afccec708378.png",
            "joggUserData/aigc/photo/25-1a0ab69d92b6449796d6e9ec0b993a3f/711bb2f6-ac1c-46bc-94c3-c0ce3a76cef9.png"
        ]
    }
}
We have generated our AI Avatar photos, now we can use these image_key to create new looks.

​
Wechat IMG58 Pn

Generate Avatar New Look Photo See detailed API reference To generate looks for the photo avatar, you can use the Generate Avatar New Look Photo API. Provide a description in the prompt field, as well as the orientation, pose, and style. 
curl --request POST \
     --url https://api.jogg.ai/v1/photo_avatar/new_look/generate \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: <your_api_key>' \
     --data '
{
    "photo_id": "https://resource2.JoggAI.ai/image/701c1dfb977d4d62bef3fda755e2d4c5/original.jgp",
    "avatar_style": "social",
    "age": "Young Adult",
    "gender": "male",
    "ethnicity": "Asian",
    "appearance": "Medium-length curly bright red hair. Wearing a black satin top with a deep V-neckline, accessorized with gold earrings.",
    "background": "A vibrant living room with asymmetrical furniture in bold primary colors, a checkerboard floor, and a sculptural glass coffee table under a geometric pendant light.",
    "model": "classic",
    "appearance": 0
}

{
  "code": 123,
  "msg": "<string>",
  "data": {
    "photo_id": "123"
  }
}

​
Check status of the look generation

Using the photo_id. See detailed API reference 
curl --request GET \
     --url https://api.jogg.ai/v1/photo_avatar/generation?photo_id=4ea4fea89c724fcfb49502c4323bac55 \
     --header 'accept: application/json' \
     --header 'x-api-key: <your_api_key>'

{
    "code": 123,
    "msg": "<string>",
    "data": {
        "photo_id": "def3076d2c8b4929acf269d8ea6b562e",
        "status": "in_progress",
        "msg": null,
        "image_url_list": null,
        "image_key_list": null
    }
}

{
    "code": 123,
    "msg": "<string>",
    "data": {
        "image_url": "def3076d2c8b4929acf269d8ea6b562e",
        "status": "error",
        "msg": null,
        "image_url_list": null,
        "image_key_list": null
    }
}

{
    "code": 123,
    "msg": "<string>",
    "data": {
        "id": "def3076d2c8b4929acf269d8ea6b562e",
        "status": "success",
        "msg": null,
        "image_url_list": [
            "https://resource2.JoggAI.ai/image/701c1dfb977d4d62bef3fda755e2d4c5/original",
            "https://resource2.JoggAI.ai/image/605e0f207d7b4c2c92923dda0d480583/original",
            "https://resource2.JoggAI.ai/image/97c92a578a824a2083947285f8b80e4e/original",
            "https://resource2.JoggAI.ai/image/2632443cb8394276b8d3046ea6748f47/original"
        ],
        "image_key_list": [
            "image/701c1dfb977d4d62bef3fda755e2d4c5/original",
            "image/605e0f207d7b4c2c92923dda0d480583/original",
            "image/97c92a578a824a2083947285f8b80e4e/original",
            "image/2632443cb8394276b8d3046ea6748f47/original"
        ]
    }
}

​
Wechat IMG57 Pn

Conclusion In conclusion, By leveraging tools like the Cenerate Avatar photo and Add Looks APIs, users can upload, organize, and enhance avatars with ease.

​
Add Motion to Your Photo Avatar

Enhance your photo avatar by adding dynamic motion and immersive sound effects! Follow this step-by-step guide to bring your avatar to life.

​
Add Motion

See detailed API reference Add motion to your photo avatar by sending a POST request to the API with the avatar’s ID. 
curl --request POST \
     --url https://api.jogg.ai/v1/photo_avatar/add_motion \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: <your-api-key>' \
     --data '{
    "photo_id": "e08fcc7348ef4f839ed31abf000cef2c",
    "image_url": "https://resource2.JoggAI.ai/image/701c1dfb977d4d62bef3fda755e2d4c5/original.jgp",
    "name": "name",
    "Description": "A vibrant living room with asymmetrical furniture in bold primary colors, a checkerboard floor, and a sculptural glass coffee table under a geometric pendant light.",
    "model": "1.0",// 2.0  2.0-Pro
    "voice_id": "0"
}'

{
    "rid": "f7c5edfc9eed0db89ef68dadf4604a6b",
    "code": 0,
    "msg": "success",
    "data": {
        "motion_id": "25-937af73859a74666b8a4572eb61b4dd5",
        "name": "name",
        "avatar_id": 155182
    }
}

​
Check status of the motion generation

See detailed API reference 
curl --request GET \
--url https://api.jogg.ai/v1/photo_avatar?motion_id=e08fcc7348ef4f839ed31abf000cef2c \
--header 'accept: application/json' \
--header 'x-api-key: <your_api_key>'

{
    "rid": "dfe19f53181dd03e372f19c947fef7f6",
    "code": 0,
    "msg": "success",
    "data": {
        "motion_id": "25-937af73859a74666b8a4572eb61b4dd5",
        "avatar_id": 155182,
        "image_url": "https://res.jogg.ai/joggUserData/aigc/photo/25-7fca6bdc66c84767ba8a7ddb9bbb4d77/e154e565-f21b-4b49-8ca0-c532aacf5c02.png",
        "name": "name",
        "status": "pending",
        "motion_preview_url": "",
        "voice_id": "tb_53310bf56ac44e27946ee76409fe9b74"
    }
}

{
    "rid": "dfe19f53181dd03e372f19c947fef7f6",
    "code": 123,
    "msg": "<string>",
    "data": {
        "motion_id": "e08fcc7348ef4f839ed31abf000cef2c",
        "avatar_id": 12399,
        "image_url": "",
        "name": "name",
        "status": "error",
        "motion_preview_url": null,
        "voice_id": 123
    }
}

{
    "error": null,
    "data": {
        "motion_id": "e08fcc7348ef4f839ed31abf000cef2c",
        "avatar_id": 12399,
        "image_url": "https://files2.JoggAI.ai/avatar/v3/e08fcc7348ef4f839ed31abf000cef2c/full/2.2/raw_preview_image.webp",
        "name": "name",
        "status": "completed",
        "motion_preview_url": "https://files2.JoggAI.ai/avatar/v3/e08fcc7348ef4f839ed31abf000cef2c/full/2.2/preview_video_target.mp4",
        "voice_id": 123
    }
}

​
Conclusion

By following the steps outlined in this guide, you can easily add dynamic motion and immersive sound effects to your photo avatars, enhancing the user experience and bringing your avatars to life.