文档中心
aigc_server 数字人 PaaS 服务
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 数字人 PaaS 服务
  • 服务端 API
  • 创建图片数字人
  • 创建图片数字人

服务端 API 版块于4月16日至5月15日升级维护,期间暂停信息更新,如有任何疑问,请联系ZEGO技术支持。

创建图片数字人

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

描述

调用本接口上传图片,并处理图片模型,生成对应图片形象 ID,供后续合成视频使用。

接口原型

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

请求参数

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

参数 类型 是否必选 描述
MetaHumanName
String
是
名称,不超过 12 个字符,用户自定义传入。
ImageUrl
String
是
图片绝对链接(格式:png),用户自定义传入。
  • 尺寸大于 256*256,单边分辨率不超过 2560P。
  • 只支持 PNG 格式,大小不超过 10MB。
  • 正面为佳,清晰的人脸五官可被识别,风格不限,人物形象需要有肩膀,可以小幅度的转动偏移。
IsGreenBg
Bool
是
指定是否为绿色背景。

  • True:绿色背景。
  • False:非绿色背景。

请求示例

  • 请求 URL

    https://aigc-api.zegotech.cn/?Action=CreateImageMetaHuman
    &AppId=1234567890
    &SignatureNonce=15215528852396
    &Timestamp=1234567890
    &Signature=7a2c0f11145fb760d607a07b54825013
    &SignatureVersion=2.0
  • 请求消息体

    {
    "MetaHumanName": "your_metahuman_name",
    "ImageUrl": "your_image_url",
    "IsGreenBg": "True"  
    }

响应参数

参数 类型 描述
Code
Number
返回码。
Message
String
操作结果描述。
Data
Object
响应对象。
MetaHumanId
String
图片数字人 ID,在 创建图片数字人异步视频合成任务 时使用 。

响应成功示例

{
    "Code": 0,
    "Message": "success",
    "Data": {
      "MetaHumanId": "1a19bf09-f8f6-45f2-bb7a-bfa4f07b227d" 
   } 
}

响应失败示例

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

返回码

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

返回码 说明 处理建议
0 成功。 -
100000004 签名过期。 请重新生成签名。
100000005 签名错误。 请确认生成签名的参数是否正确。
400000001 输入参数无效。 请根据 Message 提示,调整对应参数的取值。
400000002 数字人 PaaS 服务未开通。 请联系 ZEGO 技术支持开通权限。
400000005 未找到任务。 请确认设置的 TaskId 是否正确。
400000017 审核内容不通过。 请校验相关资源,可能存在涉黄、涉恐等问题。
400000018 资源分辨率错误。 请调整资源分辨率,保证图片单边分辨率不超过 2560p。
400010000 系统错误。 请联系 ZEGO 技术支持处理。
400010001 未获得接口调用权限。 请联系 ZEGO 技术支持开通服务权限。
400010003 资源不足。 审核服务器错误,请联系 ZEGO 技术支持处理。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈