POST
/
api
/
personas_v2

Authorizations

​
X-API-ID
string
header
required

API ID, from your settings page.

​
X-API-KEY
string
header
required

API Key, from your settings page.

Body

​
consent_video
string
required
​
creator_name
string
required

Name of the persona, used to identify the real person, not for display

Maximum length: 255
​
gender
enum<string>
required

gender of the persona

  • m - Male
  • f - Female
  • nb - Non Binary
Available options:
m,
f,
nb
​
gdown_url
string
​
keywords
string | null

keywords (comma separated)

Maximum length: 255
​
labels
string[]
​
lipsync_input
string
​
slot_id
string | null
​
video_scene
string | null

A word to describe the background setting. API user rely on this

Maximum length: 255
​
webhook_url
string | null

Webhook url, when the creator is created, we will send a webhook to the url(only for api user)

Maximum length: 200

Response

201 - application/json
​
consent_video
string
required
​
created_at
string
required
​
creator_name
string
required

Name of the persona, used to identify the real person, not for display

Maximum length: 255
​
failed_reason
string | null
required

The reason why the creator creation failed, if not failed, it should be empty

​
gender
enum<string>
required

gender of the persona

  • m - Male
  • f - Female
  • nb - Non Binary
Available options:
m,
f,
nb
​
id
string
required
​
lipsync_input_url
string
required
​
matching_voice_non_null
string
required
​
process_status
enum<string>
required

The status of creating process of the creator, if not done, it should not be shown in the UI

  • pending - Pending
  • processing - Processing
  • voice_creating - Voice Creating
  • video_validating - Video Validating
  • crop_and_matte - Crop And Matte
  • reviewing - Reviewing
  • done - Done
  • failed - Failed
  • rejected - Rejected
Available options:
pending,
processing,
voice_creating,
video_validating,
crop_and_matte,
reviewing,
done,
failed,
rejected
​
updated_at
string
required
​
gdown_url
string
​
keywords
string | null

keywords (comma separated)

Maximum length: 255
​
labels
string[]
​
lipsync_input
string
​
video_scene
string | null

A word to describe the background setting. API user rely on this

Maximum length: 255
​
webhook_url
string | null

Webhook url, when the creator is created, we will send a webhook to the url(only for api user)

Maximum length: 200
Get Avatar by IDGet the number of Custom Avatars you can create