Overview (v1)

API that converts text or audio files to vivid videos of people speaking.

🔁 We recommend upgrading to the AI Avatar v2 API for greater creative flexibility, including multi-scene composition, custom voices, backgrounds, and fine-grained control over captions and transitions.

🚀 Introduction

The AI Avatar API enables you to generate realistic, high-quality videos of virtual people speaking from any text or audio input. Whether you’re building a marketing campaign, a product demo, or an educational assistant, this API offers an intuitive way to bring your content to life—powered by customizable personas and simple integration.

---

⚙️ Quickstart Guide

✅ Prerequisites

Before you begin, ensure you have:

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

---

🧑‍🎤 Step 1: Choose a Persona

We offer 1500+ lifelike personas with diverse styles and expressions to match your use case.

• Explore the full list here: Get Personas API

This API returns a list of available personas, each with a unique id field. Use the id of the selected persona as the creator parameter when generating your video.

---

📝 Step 2: Submit a Video Generation Request

Use this endpoint to generate a video of a person speaking from text.

Example Request

curl --request POST \
  --url https://api.creatify.ai/api/lipsyncs/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "text": "hello world",
    "creator": "18fccce8-86e7-5f31-abc8-18915cb872be",
    "aspect_ratio": "9:16",
    "model_version": "aurora_v1_fast"
}'

⚠️ Save the id — you’ll need it to check the status.

---

⏳ Step 3: Check Video 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/4c0b2b3c-dcbb-4c12-8e98-a1e0643d5394 \
  --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
List Personas	GET /api/personas/
Create Task	POST /api/lipsyncs/
Check Status	GET /api/lipsyncs/{id}/
API Reference	AI Avatar API Reference

---

🤝 Need Help?

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