文档

Create2dAvatar - 提交2D自定义形象创建任务

更新时间:

提交一段真人视频素材生成对应的2D真人数字人形象,该接口会立即返回一个形象code,后续可以根据形象code调用查询、更新、删除人物接口。

接口说明

请确保在使用该接口前,已充分了解 2D 真人数字人形象定制产品的收费方式价格

该接口是一个异步任务接口,提交之后,系统将会在后台自动进行 2D 真人数字人形象的训练,调用方可以通过查询数字人资产详情接口获取训练进展,或者通过订阅数字人平台回调事件实时监听训练进展。

关于如何拍摄真人视频素材,请点击此处了解详情

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
avatar:Create2dAvatarWrite
  • Asset
    acs:avatar::{#accountId}:asset/*

请求参数

名称类型必填描述示例值
TenantIdlong

从虚拟数字人开放平台中获取的 TenantId

xxxx
Namestring

人物名称

博远
Descriptionstring

人物描述

朝气蓬勃,富有感染力,适用于播音、传媒广电、企业宣传等场景
Imagestring

人物缩略图 URL。

  • 如果不传,将会截取视频第一帧作为人物缩略图。
  • 如果传,要求分辨率和原视频分辨率保持一致,格式 png,大小<10M。
https://virtual-human-assets.oss-cn-beijing.aliyuncs.com/2d_assets/xxx/xxx/xxx.png?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx
Portraitstring

人物头像 URL。

  • 要求:尺寸 1:1,格式 png,大小<10M
https://virtual-human-assets.oss-cn-beijing.aliyuncs.com/2d_assets/xxx/xxx/xxx.png?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx
Videostring

原始视频素材 URL,要求:

  • 格式 mov、webm、mp4,针对透明视频格式推荐 webm
  • 视频时长 3-8 分钟
  • 分辨率 1080p
  • 大小<10G
https://virtual-human-assets.oss-cn-beijing.aliyuncs.com/2d_assets/xxx/xxx/xxx.mov?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx
Transparentboolean

原始视频素材是否是透明

  • true:透明格式,可支持替换背景
  • false:非透明格式,不支持替换背景
true
Orientationinteger

原始视频方向:横竖屏

  • 1: 竖屏
  • 2: 横屏
1
Callbackboolean

本次 2D 形象生成任务成功或失败是否需要事件回调,默认 false 不回调。具体可参考文档:数字人回调事件通知

false

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID

0A466686-8F3A-55A6-93D8-A0225DC965C0
Codestring

错误码

10010001
Messagestring

错误消息

这个一次错误消息。
Successboolean

是否成功

false
Dataobject

调用返回数据

Codestring

形象 code

CH_2d_xxxxxx

示例

正常返回示例

JSON格式

{
  "RequestId": "0A466686-8F3A-55A6-93D8-A0225DC965C0\n",
  "Code": "10010001",
  "Message": "这个一次错误消息。",
  "Success": false,
  "Data": {
    "Code": "CH_2d_xxxxxx"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-10-17API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
  • 本页导读 (0)