Avatar
Get all available Avatars with pagination
API Documentation
Link to videos
Links
Lipsyncs
Lipsyncs v2
Text to Speech
AI Shorts
AI Editing
Custom Templates
Avatar
Workspace
Avatar
Get all available Avatars with pagination
Returns a paginated list.
GET
/
api
/
personas
/
paginated
curl --request GET \
--url https://api.creatify.ai/api/personas/paginated/ \
--header 'X-API-ID: <api-key>' \
--header 'X-API-KEY: <api-key>'
{
"count": 123,
"next": "<string>",
"previous": "<string>",
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"gender": "m",
"age_range": "child",
"location": "outdoor",
"style": "selfie",
"creator_name": "<string>",
"video_scene": "<string>",
"keywords": "<string>",
"preview_image_16_9": "<string>",
"preview_image_1_1": "<string>",
"preview_image_9_16": "<string>",
"preview_video_16_9": "<string>",
"preview_video_1_1": "<string>",
"preview_video_9_16": "<string>",
"landscape_preview_video": "<string>",
"squared_preview_video": "<string>",
"is_active": true,
"process_status": "<string>",
"failed_reason": "<string>",
"type": "<string>"
}
]
}
Authorizations
API ID, from your settings page.
API Key, from your settings page.
Query Parameters
Page number to fetch
Required range:
x >= 1
Number of items per page
Required range:
x >= 1
Response
200 - application/json
gender of the persona
m
- Malef
- Femalenb
- Non Binary
Available options:
m
, f
, nb
Landscape preview video of the persona
Squared preview video of the persona
Is the creator active to use, if not, it will not be shown in the UI
age range of the persona
child
- Childteen
- Teenadult
- Adultsenior
- Senior
Available options:
child
, teen
, adult
, senior
location of the persona
outdoor
- Outdoorfantasy
- Fantasyindoor
- Indoorother
- Other
Available options:
outdoor
, fantasy
, indoor
, other
style of the persona
selfie
- Selfiepresenter
- Presenterother
- Other
Available options:
selfie
, presenter
, other
A word to describe the background setting. API user rely on this
Maximum length:
255
keywords (comma separated)
Maximum length:
255
curl --request GET \
--url https://api.creatify.ai/api/personas/paginated/ \
--header 'X-API-ID: <api-key>' \
--header 'X-API-KEY: <api-key>'
{
"count": 123,
"next": "<string>",
"previous": "<string>",
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"gender": "m",
"age_range": "child",
"location": "outdoor",
"style": "selfie",
"creator_name": "<string>",
"video_scene": "<string>",
"keywords": "<string>",
"preview_image_16_9": "<string>",
"preview_image_1_1": "<string>",
"preview_image_9_16": "<string>",
"preview_video_16_9": "<string>",
"preview_video_1_1": "<string>",
"preview_video_9_16": "<string>",
"landscape_preview_video": "<string>",
"squared_preview_video": "<string>",
"is_active": true,
"process_status": "<string>",
"failed_reason": "<string>",
"type": "<string>"
}
]
}