AiAvatar Query

This is your first endpoint! Edit this page to start documenting your API.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Response

FieldTypeDescription
codeStringThe response code indicating status
messageStringMessage describing the response
resultObjectContains the result of the request
result.totalNumberTotal number of AI avatars available
result.pageNoNumberCurrent page number
result.pageSizeNumberNumber of items per page
result.dataArrayList of AI avatar objects
result.data[].aiavatarIdStringUnique identifier for the AI avatar
result.data[].aiavatarNameStringName of the AI avatar
result.data[].typeNumber0,1: Video digital avatar
2: Image digital avatar
result.data[].genderStringGender of the AI avatar (if available)
result.data[].coverUrlStringURL of the cover image for the AI avatar
result.data[].previewVideoUrlStringURL of the preview video for the AI avatar
result.data[].ethnicitiesStringEthnicities associated with the AI avatar (if available)
result.data[].voiceoverIdDefaultStringDefault voiceover ID for the AI avatar (if available)
result.data[].faceSquareConfigObjectConfiguration for the face square
result.data[].faceSquareConfig.y_fNumberY-coordinate in fractional format
result.data[].faceSquareConfig.wNumberWidth of the face square
result.data[].faceSquareConfig.hNumberHeight of the face square
result.data[].faceSquareConfig.xNumberX-coordinate in pixels
result.data[].faceSquareConfig.yNumberY-coordinate in pixels
result.data[].faceSquareConfig.h_fNumberHeight in fractional format
result.data[].faceSquareConfig.x_fNumberX-coordinate in fractional format
result.data[].faceSquareConfig.w_fNumberWidth in fractional format
Query Params
number
Defaults to 1

The page number. Default value: 1.

number
Defaults to 20

The data size per page. Default value: 20.

string
enum

male/female

Allowed:
ethnicityIdList
array of strings

Ethnicity id list

ethnicityIdList
string
enum

Sort field. Default value:sort. Allowed values: sort shelvingTime

Allowed:
string
enum

Sort by decs/asc. Default: desc. Allowed values: asc desc

Allowed:
string
Defaults to false

Whether search custom avatar. Default: false

Headers
string
required
Defaults to <your-topview-uid>
string
required
Defaults to Bearer <your-api-key>
Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json