# 数字人-API接入

采用数字模拟技术生成虚拟人形象, 根据用户输入的语音信息完成动作口型匹配, 并输出完整视频

# 任务创建

根据输入参数创建算法任务并返回任务id

# 请求地址

/v3/pic/virtual_human/batch

# 请求参数

Method

post

Header

Field	Required	Type	Value	Description
Content-Type	YES	string	application/json
Authorization	YES	string	Basic xxxxxxxxx	用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret)

Body

Field	Son Field	Required	Type	Description
lang	-	NO	string	传入的语音链接(audio_url)的内容所使用的语言, zh或是en
digital_id	-	YES	string	数字人形象的id
audio_url	-	YES	string	语音链接, 传入可下载链接

digital_id的可选参数

数字人digital_id值	数字人形象示例
Claire_1
Shenglun_3
Wangzhaoyang_1
Wangzhaoyang_2
Yui_3
Zhouyuhang_1
Zhouyuhang_2

示例代码

{
  "audio_url": "https://ailab-storage-alisz.oss-cn-shenzhen.aliyuncs.com/linhui/aidp/tts_s1_27.mp3?OSSAccessKeyId=LTAI5tEbdrxALVqaoYpqx49o&Expires=1720771164&Signature=KOILniu1F6W3zlZjmfVJsHBYLec%3D",
  "digital_id": "Alena_3",
  "lang": "zh"
}

# 输入文件限制

音频文件格式	音频文件时长
mp3	不超过10s

# 返回数据

Body

Field	Son Field	Required	Type	Description
code	-	YES	number	状态码, 490027:余额不足错误
msg	-	YES	string	请求信息
data	-	YES	object	响应数据
-	task_id	YES	string	任务id

示例代码

{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "6a4eab77-be30-430a-bf0e-3048042a34ef"
  }
}

# 结果获取

根据任务id 请求任务处理结果

# 请求地址

/v3/pic/virtual_human/result/{task_id}/{task_id}

# 请求参数

Method

get

Header

Field	Required	Type	Value	Description
Content-Type	YES	string	application/json
Authorization	YES	string	Basic xxxxxxxxx	用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret)

路径参数

Field	Son Field	Required	Type	Value	Description
task_id	-	YES	string		任务id

# 返回数据

Body

Field	Son Field	Required	Type	Description
code	-	YES	number	状态码
msg	-	YES	string	请求信息
data	-	YES	object	响应数据
-	status	YES	string	任务状态状态：1- 等待中；2-进行中；3-任务完成；4-任务失败；5-任务关闭 6-任务超时 7-余额不足 8-内容敏感
-	wait_time	YES	string	等待时间
-	reason	YES	string	失败原因
-	result	YES	string	结果url地址

← 简介简介 →