Create Custom Avatar (v2)

FreshPOST

POST https://api.creatify.ai/api/personas_v2/

Create a new v2 custom avatar with consent verification and improved lipsync quality. V2 requires uploading both a consent video and lipsync training files.

Request Body

Name	Type	Required	Description
name	string	Yes	Name for the custom avatar
consent_video_url	string	Yes	URL to the consent video (person must state their consent on camera)
lipsync_video_url	string	Yes	URL to the lipsync training video
image_url	string	No	Optional reference image URL

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key
Content-Type	string	Yes	application/json

Example Request

curl -X POST 'https://api.creatify.ai/api/personas_v2/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Brand Ambassador v2",
    "consent_video_url": "https://example.com/consent-video.mp4",
    "lipsync_video_url": "https://example.com/lipsync-training.mp4"
  }'

Response

{
  "id": "persona-v2-001",
  "name": "Brand Ambassador v2",
  "status": "processing",
  "consent_verified": false,
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

Code	Description
201	Avatar creation started
400	Bad request -- invalid parameters or consent video
401	Unauthorized -- invalid API credentials
402	Insufficient credits
429	Rate limit exceeded
500	Internal server error

Consent Requirements

The consent video must show the person clearly stating their consent to have their likeness used for AI avatar generation. Videos that do not meet consent requirements will be rejected.

TIP

The lipsync training video should be 30-60 seconds of the person speaking clearly, facing the camera. Good audio quality significantly improves lipsync accuracy.