List Custom Avatars (v2)

FreshGET

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

Retrieve a list of all v2 custom avatars. V2 avatars support enhanced features including consent verification and improved lipsync quality.

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key

Example Request

curl -X GET 'https://api.creatify.ai/api/personas_v2/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key'

Response

[
  {
    "id": "persona-v2-001",
    "name": "Brand Ambassador",
    "status": "active",
    "version": "v2",
    "thumbnail": "https://cdn.creatify.ai/personas/v2-001-thumb.jpg",
    "consent_verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
]

Status Codes

Code	Description
200	Success
401	Unauthorized -- invalid API credentials
429	Rate limit exceeded
500	Internal server error

TIP

V2 avatars offer improved lipsync accuracy and require consent verification. Use POST /api/personas_v2/ to create v2 avatars.