文档中心
aigc_server 数字人 PaaS 服务
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 数字人 PaaS 服务
  • 服务端 API
  • 查询视频数字人
  • 查询数字人模特列表

查询数字人模特列表

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

描述

调用本接口查询指定 AppID 下可用的数字人模特列表。

接口原型

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

请求参数

本接口只需传入公共参数,公共参数列表请参考 调用方式 - 公共请求参数。

请求示例

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

响应参数

参数 类型 描述
Code
Int
错误码。
Message
String
错误描述。
Data
Object
响应对象。
MetaHumanModels
Array Of Object
数字人模特列表。
MetaHumanModelId
String
数字人模特 ID。
MetaHumanModelName
String
数字人模特名称。
Gender
Int
性别。
  • 1:男。
  • 2:女。
Visibility
Int
类型。
  • 1:公用。
  • 2:定制。
AvatarUrl
String
数字人模特图片的 URL,访问有效期 24 小时。

响应示例

{
    "Code": 0,
    "Message": "succeed",
    "Data": {
        "MetaHumanModels": [
            {
                "MetaHumanModelId": "01e6b34d-15ea-4579-86ef-55839709402e",
                "MetaHumanModelName": "即源-1",
                "Gender": 1,
                "Visibility": 1,
                "AvatarUrl": "https://xxx.xxx.xxx.com/xxx.jpeg"
            },
            {
                "MetaHumanModelId": "286c3d62-848c-4fbd-b3bd-9108bfa7333c",
                "MetaHumanModelName": "美丽",
                "Gender": 2,
                "Visibility": 1,
                "AvatarUrl": "https://xxx.xxx.xxx.com/xxx.png"
            }
        ]
    }
}

返回码

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

返回码 说明 处理建议
0 成功。 -
100000004 签名过期。 请重新生成签名。
100000005 签名错误。 请确认生成签名的参数是否正确。
400000002 数字人 PaaS 服务权限未开通。 请联系 ZEGO 技术支持开通服务权限。
400010000 系统错误。 请联系 ZEGO 技术支持处理。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈