​
Introduction

Our AI model produces high-quality videos of many people speaking from a list of texts, voices and avatars. The API is designed to be simple and easy to use.

​
Quickstart

​
Prerequisite

  • You need a creatify.ai account with API access.
  • You need to go through the Get your API key

​
Queue a generation task

Generate a video of many person speaking from a list of texts, voices and avatars by calling the multi avatar endpoint .

avatar_id is the unique identifier of an avatar. You can get the avatar_id by calling the Get avatar endpoint.

voice_id is the unique identifier of the voice. You can get the voice_id by calling the Get voices interface.

import requests

url = "https://api.creatify.ai/api/lipsyncs/multi_avatar/"

payload = {
  "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"
}

headers = {
    "X-API-ID": "<your-x-api-id>",
    "X-API-KEY": "<your-x-api-key>",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

​
Check status

Now our AI model is generating a video of many person speaking from the texts you provided. It will return a id of the lipsync item. Then you can check the status of your video generation by sending a GET request to Get lipsync item by id endpoint.

import requests

url = "https://api.creatify.ai/api/lipsyncs/{id}/"

headers = {
    "X-API-ID": "<your-x-api-id>",
    "X-API-KEY": "<your-x-api-key>"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Once the status is done, you can download the video, the link of the video is in the output field.

​
Personas

We offer 100+ personas, you can find the full list here.

AI Avatar APIAI Shorts API