形象训练

总体流程

1. 调用创建分身数字人模型训练任务接口创建任务ID和文件上传链接。
2. 使用Postman工具，将文件上传至URL地址中。
3. 调用租户执行分身数字人模型训练任务命令接口，确认文件已上传成功并提交形象训练任务。

操作步骤

1. 单击创建分身数字人模型训练任务，进入MetaStudio服务的API Explorer页面。

   参数“name”为数字人名称，其余参数的配置详见创建分身数字人模型训练任务。

   参数配置完成后，单击“调试”，如果状态码返回200，说明接口调用成功。需要记录下返回字段job_id（任务ID）的值和上传链接。

   图1 接口页面
   

2. 上传训练文件至第1步中返回的文件上传地址（有效期为24小时），如图2所示。

   详细操作说明，如下所示：

   在Postman工具中，将xxx_upload_url地址作为请求地址，使用PUT方式依次上传下述必要文件。

   • URL：
     • training_video_upload_url：形象训练视频
     • id_card_image1_upload_url：身份证人像面
     • id_card_image2_upload_url：身份证国徽面
     • grant_file_upload_url：形象授权书
   • Params：已包含在upload_url地址中，已携带鉴权信息，无需更改。
   • Headers：添加Content-Type，取值为application/octet-stream。
   • Body：待上传文件，选择binary形式。

   如果状态码返回200，说明文件上传成功。

   图2 上传文件
   

3. 在左侧导航栏中选择“分身形象制作管理 > 租户执行分身数字人模型训练任务命令。

   请求体参数配置说明，如下所示，其余参数配置详见租户执行分身数字人模型训练任务命令。

   • job_id：第1步获取到的任务id。
   • command：命令类型。

   分几次调用接口，依次执行“CONFIRM_MULTIPART_UPLOADED”确认文件已上传、“SUBMITVERIFYING”提交任务。

   如果状态码返回200，并且响应体中的commond_result为EXCUTE_SUCCESS，说明命令执行成功。至此，模型训练任务创建动作完成。

   

   提交任务并在首次审核通过后不支持删除任务，测试用途请谨慎提交。

   图3 接口页面
   

4. （可选操作）前面3个步骤执行完成后，可以使用任务ID，通过查询分身数字人模型训练任务详情接口查看任务进度。也可以在MetaStudio控制台的“任务中心 > 分身形象制作”页面选择对应任务查看详情。
5. （可选操作）如果上传地址过期或审核不通过，可以获取更新任务相关文件的上传链接。

   单击更新分身数字人模型训练任务，进入MetaStudio服务的API Explorer页面。

   请求体参数配置说明，如下所示，其余参数配置详见更新分身数字人模型训练任务。

   • job_id：第1步获取的任务ID。
   • video_multipart_count：形象训练视频上传的分片数。

   单击“调试”，如果状态码返回200，说明接口调用成功。需要记录下返回的上传链接，按照第2步和第3步流程重新上传并提交。

   图4 接口页面
   

常见错误

上传资产失败的常见错误，如下所示：

• 第2步上传失败，可能原因如下：
  • Content-Type设置错误。
  • 传了Content-MD5。
  • 上传文件时，没有以二进制流binary方式上传。
• 第3步返回EXCUTE_FAILED，可能原因如下：
  • 必要文件未提交时，就已执行SUBMITVERIFYING命令。
  • 无权限执行NA白名单用户的命令。
  • 当前任务状态不支持执行该命令。
• 如果响应错误码“MSS.00024001”，说明使用区域可能有误，请尝试切换至“华北-北京四”使用。
• 如果响应错误提示“资源不足”，可能原因如下：
  • 购买的资源余量已不足。
  • is_flexus字段设置错误。
  • 更新任务文件时使用了创建接口。

其他问题

• 任务一直处于“待上传文件”状态（WAIT_FILE_UPLOAD），说明未完成操作步骤中的前3个操作步骤，请检查上传流程。
• 更新任务时未返回形象训练视频的上传地址，说明video_multipart_count未设置。
• is_background_replacement设置为true但未抠像。请检查购买的资源版本，如果is_flexus为true则不支持抠像。