After generating Photo Avatars, you can use them in the Create Avatar Video API to generate videos.
API Reference

Get Photo Avatar ID

If you already have a photo avatar ID from previous steps, you can skip this step.

Avatar Group: Get the avatar group ID. You can use this ID or view other looks and choose a different look ID.

curl -L 'https://api.heygen.com/v2/avatar_group.list' \
-H 'X-Api-Key: <your-api-key>' \
-H 'Content-Type: application/json' \

{
  "error": null,
  "data": {
    "total_count": 16,
    "avatar_group_list": [
      {
        "id": "0b1b8dabd16f40a2b2ae6599790bba05",
        "name": "Sylvia",
        "created_at": 1737662356.0,
        "num_looks": 14,
        "preview_image_url": null,
        "group_type": "PHOTO",
        "train_status": "ready"
      },
...

Avatar Group Looks: Choose the avatar look ID here.

curl -L 'https://api.heygen.com/v2/avatar_group/<group_id>/avatars' \
-H 'X-Api-Key: <your-api-key>' \
-H 'Content-Type: application/json' \

{
  "error": null,
  "data": {
    "avatar_list": [
      {
        "id": "d1878a9f3abd4535904f748f9e23182c",
        "image_url": "<image_url>",
        "created_at": 1741612869.0,
        "name": "new look",
        "status": "completed",
        "group_id": "0b1b8dabd16f40a2b2ae6599790bba05",
        "is_motion": false,
        "motion_preview_url": null,
        "business_type": "generated",
        "upscale_availability": {
          "available": false,
          "reason": "The photo avatar look is too large to upscale"
        },
        "upscaled": false,
        "background_sound_effect": null
      },
...

Create a Video with the Photo Avatar

See detailed API reference
To generate Photo Avatar videos you need to change "Character Settings" type as talking_photo then you need to provide talking_photo_id you got in the previous step.

curl -X POST https://api.heygen.com/v2/video/generate \
-H 'X-Api-Key: <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{
  "video_inputs": [
    {
      "character": {
        "type": "talking_photo",
        "talking_photo_id": "<talking_photo_id>"
      },
      "voice": {
        "type": "text",
        "input_text": "With HeyGen, it is very easy to create Photo Avatar videos.",
        "voice_id": "d7bbcdd6964c47bdaae26decade4a933"
      }
    }
  ]
}'

{
  "code": 100,
  "data": {
    "video_id": "<video_id>"
  },
  "message": "Success"
}