文档中心
数字人 PaaS 服务
服务端 API
创建图片数字人
查询图片数字人列表

查询图片数字人列表

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

描述

调用本接口可查询账户下，已训练完成的图片数字人形象列表。

接口原型

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

请求参数

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

请求示例

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

响应参数

参数	类型	描述
Code	Number	返回码。
Message	String	操作结果描述。
Data	Object	响应对象。
MetaHumans	Array of Object	数字人形象列表。
MetaHumanId	String	数字人形象 ID。
MetaHumanName	String	数字人形象名称。
AvatarUrl	String	数字人形象图片 URL，访问有效期 24 小时。

响应成功示例

{
    "Code": 0,
    "Message": "success",
    "Data": {
      "MetaHumans": [
        {
          "MetaHumanId": "2b8994f0-b31d-4d87-ad23-1613e1762260",
          "MetaHumanName": "meta_human_name",
          "AvatarUrl": "image_url" 
        }] 
     } 
}

响应失败示例

{
    "Code": 400010001,
    "Message": "service not available"
}

返回码

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

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