文档中心
数字人 PaaS 服务
服务端 API
查询精品数字人
查询数字人模特详情

查询数字人模特详情

更新时间：2025-04-15 19:16

描述

调用本接口，传入数字人模特 ID，即可查询该模特下所有数字人形象的详情。

一个数字人模特可以有多个数字人形象。

接口原型

请求方法：POST
中国大陆正式环境请求地址：https://aigc-api.zegotech.cn/?Action=DescribeMetaHumanModelDetail
传输协议：HTTPS
调用频率限制：10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数，公共参数列表请参考调用方式 - 公共请求参数。

参数	类型	是否必选	描述
MetaHumanModelId	String	是	数字人模特 ID，通过查询数字人模特列表获得。

请求示例

请求 URL

https://aigc-api.zegotech.cn/?Action=DescribeMetaHumanModelDetail
&AppId=1234567890
&SignatureNonce=15215528852396
&Timestamp=1234567890
&Signature=7a2c0f11145fb760d607a07b54825013
&SignatureVersion=2.0

请求消息体

{
    "MetaHumanModelId": "your_metahumanmodel_id"
}

响应参数

参数	类型	描述
Code	Int	错误码。
Message	String	错误描述。
Data	Object	响应对象。
MetaHumans	Array Of Object	数字人形象列表。
MetaHumanId	String	数字人形象 id。
MetaHumanName	String	数字人形象名称。
Visibility	Int	类型。 1：公用。 2：定制。
AvatarUrl	String	数字人形象图片的 URL，访问有效期 24 小时。
MicroCoverUrl	String	数字人形象头像 URL，访问有效期 24 小时。
ActionPreview	Array of Object	数字人动作预览。
ActionName	String	数字人动作名称。
ActionUrl	String	数字人动作预览视频 URL。

响应示例

{
    "Code": 0,
    "Message": "succeed",
    "Data": {
        "MetaHumans": [
            {
                "MetaHumanId": "875a9aa9-2327-41a5-8ff6-607ee1651f24",
                "MetaHumanName": "Name1",
                "Visibility": 1,
                "AvatarUrl": "https://xxx.xxx.xxx.com/xxx.png",
                "ActionPreview": [
                    {
                        "ActionName": "action_hello",
                        "ActionUrl": "https://xxx.xxx.xxx.com/xxx.mp4"
                    },
                    {
                        "ActionName": "action_sit",
                        "ActionUrl": "https://xxx.xxx.xxx.com/xxx.mp4"
                    }
                ]
            },
            {
                "MetaHumanId": "2e2301b0-bd93-4c9d-b140-def8af821bd3",
                "MetaHumanName": "Name2",
                "Visibility": 1,
                "AvatarUrl": "https://xxx.xxx.xxx.com/yyy.jpg",
                "MicroCoverUrl": "https://xxx.xxx.xxx.com/yyy.jpg"
            }
        ]
    }
}

返回码

以下仅列出了常见的接口业务逻辑相关的返回码，完整返回码请参考全局返回码。

返回码	说明	处理建议
0	成功。	-
100000004	签名过期。	请重新生成签名。
100000005	签名错误。	请确认生成签名的参数是否正确。
400000001	输入参数无效。	请根据 Message 提示，调整对应参数的取值。
400000002	数字人 PaaS 服务权限未开通。	请联系 ZEGO 技术支持开通服务权限。
400010000	系统错误。	请联系 ZEGO 技术支持处理。