AI Avatar v2 API

Generate vivid, personalized videos featuring multiple scenes — each with its own avatar, voice, background, and styling — using a structured list of inputs.

🚀 Introduction

We recommend trying our Lipsync V2 API — a powerful and flexible way to generate rich, multi-scene videos tailored to your brand, message, or audience.

With this API, you can define a list of video segments and customize each with:

• 🎭 Character (avatar) selection
• 🗣️ Text-to-voiceover (with your chosen voice and accent)
• 🖼️ Background image or video
• 🎯 Call-to-action (CTA) options
• ✍️ Caption position, style, and formatting

This gives you full control to create immersive, story-driven content that matches your creative needs.

🚀 Follow our Quickstart Guide below to get up and running in minutes.

---

⚙️ Quickstart Guide

✅ Prerequisites

Before you begin, ensure you have:

• A Creatify account with API access
• Your API credentials (see Authentication Guide)

---

👤 Step 1: Choose Avatars and Voices

You’ll need an avatar_id and a voice_id for each speaking segment.

• Use the Get Avatars API to retrieve avatar_id
• Use the Get Voices API to retrieve voice_id

Each avatar + voice combination represents one unique speaker.

👨‍🎤 Personas

Browse Personas Here

We offer 750+ unique personas to bring your videos to life:

---

🎙️ Voices

Browse Voices Here

Creatify offers a wide range of AI voices that bring your avatars to life with natural, expressive speech. Each voice supports multiple accents so you can tailor the sound to your audience or region.

To select a voice, use the voice_id from the accent you want in your request. This provides fine-grained control over tone, language, and personality.

• Use voice_id to override the default voice associated with an avatar.
• If voice_id is not provided, the system will use the default voice linked to the selected avatar.

💡 Each voice includes multiple accents — select the one that fits your content best using the provided id.

Example Response from GET /api/voices/

[
  {
    "name": "Fatima",
    "gender": "female",
    "accents": [
      {
        "id": "3480f048-8883-4bdc-b57f-4e7078e94b18",
        "accent_name": "American English accent",
        "preview_url": "https://d35ghwdno3nak3.cloudfront.net/accent_preview_new_/el-689d6bc2-c93e-4a50-a36b-3b171c729843_s.mp3"
      }
    ]
  }
]

Use the id from the accents list as your voice_id in the video generation request.

---

📅 Step 2: Submit a Video Generation Request

Use the Lipsync v2 Endpoint to submit a video generation request.

Example Request

curl --request POST \
  --url https://api.creatify.ai/api/lipsyncs_v2/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "video_inputs": [
        {
            "character": {
                "type": "avatar",
                "avatar_id": "7350375b-9a98-51b8-934d-14d46a645dc2",
                "avatar_style": "normal",
                "offset": {
                    "x": -0.23,
                    "y": 0.35
                }
            },
            "voice": {
                "type": "text",
                "input_text": "Absolutely mind-blowing! The Apple Vision Pro turns any room into a cinematic experience with its Spatial Audio and Immersive Video.",
                "voice_id": "6f8ca7a8-87b9-4f5d-905d-cc4598e79717"
            },
            "background": {
                "type": "image",
                "url": "https://video.creatify.ai/bg.jpg"
            },
            "caption_setting": {
                "style": "normal-black",
                "offset": {
                    "x": 0,
                    "y": 0.45
                }
            }
        },
        {
            "character": {
                "type": "avatar",
                "avatar_id": "18fccce8-86e7-5f31-abc8-18915cb872be",
                "avatar_style": "normal",
                "offset": {
                    "x": -0.23,
                    "y": 0.35
                }
            },
            "voice": {
                "type": "text",
                "input_text": "Truly, a next-level entertainment device. Get yours now and experience the magic firsthand!",
                "voice_id": "360ab221-d951-413b-ba1a-7037dc67da16"
            },
            "background": {
                "type": "image",
                "url": "https://video.creatify.ai/bg.jpg"
            },
            "caption_setting": {
                "style": "normal-black",
                "offset": {
                    "x": 0,
                    "y": 0.45
                }
            }
        }
    ],
    "aspect_ratio": "9x16"
}'

⚠️ Save the id — you’ll use it to check progress.

---

⏳ Step 3: Check Generation Status

After submitting a video generation request, use the returned task ID to monitor progress and retrieve the completed video when it’s ready.

Example Request

curl --request GET \
  --url https://api.creatify.ai/api/lipsyncs_v2/0a15fff5-8906-4de0-bbf2-511bd3b5db23/ \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key'

⏳ Once the status is done, download the video from the output field.

---

🎯 Summary

Step	Endpoint
Get Avatars	GET /api/personas/
Get Voices	GET /api/voices/
Create Task	POST /api/lipsyncs/multi_avatar/
Check Status	GET /api/lipsyncs/{id}/
API Reference	Multi-Avatar Reference

---

🤝 Need Help?

If you run into any issues, check out our API Reference or contact [e-mail].