AiAvatar Query - Topview-api

Request

Query Params

pageNo

integer

optional

第几页。默认值：1

pageSize

integer

optional

每页size。默认值：20

gender

string

optional

male/female

ethnicityIdList

array[string]

optional

人种id列表

sortField

enum<string>

optional

排序方式。默认值：sort

Allowed values:

sortshelvingTime

sortType

enum<string>

optional

升序/降序排序。默认值：desc

Allowed values:

ascdesc

isCustom

boolean

optional

私模数字人。默认值：false

Header Params

Topview-Uid

string

required

Example:

NsESlcgHzduRte5CcJn3

Authorization

string

required

Example:

Bearer sk-KKYbX8ac7EJ_9MvWXssSLKOkDT0_Dtwq7G6iGteJhxU

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api.topview.ai/v1/aiavatar/query?pageNo=&pageSize=&gender=&ethnicityIdList&sortField&sortType&isCustom=' \
--header 'Topview-Uid: NsESlcgHzduRte5CcJn3' \
--header 'Authorization: Bearer sk-KKYbX8ac7EJ_9MvWXssSLKOkDT0_Dtwq7G6iGteJhxU'

Responses

🟢200OK

application/json

Body

code

string

required

message

string

required

result

object

required

total

integer

required

pageNo

integer

required

pageSize

integer

required

data

array [object {8}]

required

success

boolean

required

Example

{
    "code": "string",
    "message": "string",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "aiavatarId": "string",
                "aiavatarName": "string",
                "gender": "string",
                "coverUrl": "string",
                "previewVideoUrl": "string",
                "ethnicities": [
                    {
                        "ethnicityId": "string",
                        "ethnicityName": "string"
                    }
                ],
                "voiceoverIdDefault": "string",
                "faceSquareConfig": {
                    "y_f": 0,
                    "w": 0,
                    "h": 0,
                    "x": 0,
                    "y": 0,
                    "h_f": 0,
                    "x_f": 0,
                    "w_f": 0
                }
            }
        ]
    },
    "success": true
}