Create Custom Avatar (v1)

FreshPOST

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

Create a new custom avatar (v1). Upload a video or image of a person to create a reusable AI avatar.

Request Body

Name	Type	Required	Description
name	string	Yes	Name for the custom avatar
video_url	string	Conditional	URL to a video of the person. Required if image_url is not provided
image_url	string	Conditional	URL to an image of the person. Required if video_url is not provided

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/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Company Spokesperson",
    "video_url": "https://example.com/spokesperson-video.mp4"
  }'

Response

{
  "id": "persona-001",
  "name": "Company Spokesperson",
  "status": "processing",
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

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

TIP

For best results, use a video with clear facial features, good lighting, and minimal background movement. The person should face the camera directly.

WARNING

Consider using v2 avatars (POST /api/personas_v2/) for improved quality and consent verification support.