虚拟形象生成

一、接口描述

1. 功能描述

数字虚拟人，作为多模态交互的可视化产品形态，可应用在多种业务场景。本AI的主要功能为：对用户给定的文字内容，输出虚拟人朗读此段文字的视频文件。

2. 能力说明：

支持文本输入，进行文本转语音，通过音频驱动虚拟形象，输出音视频同步，且表情自然、动作协调的合成视频，视频文件存储在指定路径，支持用户下载。

1. 预置虚拟形象及声音，为用户提供形象租用服务
2. 支持形象定制和扩展
3. 预设2个形象，预设2个音色，预设1个科技风格背景
4. 输出的视频格式为h.264编码的MP4文件，视频分辨率为1920*1080，视频帧率为25fps，码率为4mbps
5. 虚拟形象为真人风格，头肩形象，内容播报时面部中性表情及微笑表情的自然切换，可形成小幅度头肩动作。

3. 接口数据要求：

1. 输入文本为中文文本，文本仅支持UTF-8格式

4. 接口使用：

平台为每个API提供试用体验服务，您在AI市场选择“免费试用”规格下单后，即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制，如需更高性能的API服务，可以提交咨询工单，联系京东AI扩容购买。

在获得使用权限后，您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发，整体流程详见 接入流程

二、请求说明

虚拟人形象生成服务共包括两个API：

1. 任务创建API：创建一个虚拟形象生成任务
2. 结果查询API：获取虚拟形象生成任务进度及结果

用户需要先调用创建任务API，任务成功创建后，会返回给用户对应的任务ID；然后，用户可以通过任务ID来查询该任务的进度和结果，若虚拟形象视频生成完毕，则会返回相应的视频链接供用户下载。

任务创建API和结果查询API的说明如下：

（一）任务创建API

1. 接口地址 ：

https://aiapi.jd.com/jdai/virtual_human_create_task

2. 请求方式：

post

3. 请求参数

（1）query请求参数

公共请求参数

（2）header请求参数

业务请求参数

（3）body请求参数

业务请求参数

虚拟人形象及ID对应关系如下表所示：

4、请求代码示例

建议您使用我们提供的SDK进行调用，SDK获取及调用方式详见本页一接口描述中的4接口使用

（二）结果查询API

1. 接口地址 ：

https://aiapi.jd.com/jdai/virtual_human_get_task_status

2. 请求方式：

post

3. 请求参数

（1）query请求参数

公共请求参数

（2）header请求参数

业务请求参数

（3）body请求参数

业务请求参数

4、请求代码示例

建议您使用我们提供的SDK进行调用，SDK获取及调用方式详见本页一接口描述中的4接口使用

三、返回说明

（一）任务创建API

1、返回参数

（1）公共返回参数

（2）业务返回参数

result参数信息

2、返回示例

Status Code: 200
Time：550ms
Date：Thu 8 Nov 2018 03:08:40 GMT
Body：
{
    "code": "0",
    "charge": false,
    "remain": 0,
    "msg": "查询成功",
    "result":  {
        "status_code": "0",
        "status_message": "success",
        "task_id": "abc87hdsvb32nb9u"
   }
}

（二）结果查询API

1、返回参数

（1）公共返回参数

（2）业务返回参数

result参数信息

2、返回示例

Status Code: 200
Time：550ms
Date：Thu 8 Nov 2018 03:08:40 GMT
Body：
{
    "code": "0",
    "charge": false,
    "remain": 0,
    "msg": "查询成功",
    "result":  {
        "status_code": "0",
        "status_message": "success",
        "task_id": "abc87hdsvb32nb9u",
        "progress": 0.95,
        "video_url": "http://example_video_url......"
   }
}

四、错误码

1.系统级错误码

详见返回码

2.业务错误码