文档中心

Appearance

拉取形象列表 ​

请求地址 ​

http
POST /open/v1/list_customised_person
http
access_token: {{access_token}}

请求参数 Body ​

json
{
  "page": 1,
  "page_size": 20
}

参数说明

字段说明
page当前页
page_size每页数量

响应 ​

响应JSON ​

json
{
    "trace_id": "64e18685b3181c7753513267ce7c5edb",
    "code": 0,
    "msg": "success",
    "data": {
        "list": [
            {
                "id": "C-ef91f3a6db3144ffb5d6c581ff13c7ec",
                "name": "open_api_测试",
                "type": "person",
                "pic_url": "https://changjing.cc/res/3c628295c46d8cee735fb0ec923639a5c0d820d1-cover.png",
                "preview_url": "https://changjing.cc/res/81baa81b-5f6f-40a4-8f88-1575967c9275_480.mp4",
                "width": 960,
                "height": 544,
                "audio_man_id": "C-0ae461135d8a4eb2b59c853162ea9848",
                "status": 2,
                "err_reason": "",
                "is_open": 1,
                "reason": "",
                "progress": 100
            }
        ],
        "page_info": {
            "page": 1,
            "size": 20,
            "total_count": 1,
            "total_page": 1
        }
    }
}

响应字段说明 ​

一级字段二级字段三级字段说明
code响应状态码
msg响应消息
data响应数据
list形象列表数据
id数字人形象id
name数字人名称
type类型，默认person
pic_url预览封面图
preview_url预览地址
width形象宽度
height形象高度
audio_man_id数字人的声音音色id
status当前状态: 1制作中，2成功，4失败，5系统错误
err_reason失败后显示错误原因
is_open是否可用，1可用，0不可用
reason失败原因
progress进度百分比，0-100。
page_info分页信息
page当前页码
size页面大小
total_count数字人总数
total_page总页数

响应状态码说明 ​

code说明
0响应成功
400传入参数格式错误
10400AccessToken验证失败
APP状态有误
40000参数错误
50000系统内部错误
51000系统错误