# 形象训练
本节演示如何通过[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/sdk?api=CreateDigitalAsset)和Postman工具，将形象训练素材上传至OBS桶并提交形象训练任务。
#### 总体流程
1. 调用[创建分身数字人模型训练任务](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/sdk?api=Create2dModelTrainingJob)接口创建任务ID和文件上传链接。
2. 使用Postman工具，将文件上传至URL地址中。
3. 调用[租户执行分身数字人模型训练任务命令](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/doc?api=Execute2dModelTrainingCommandByUser)接口，确认文件已上传成功并提交形象训练任务。
 
 #### 操作步骤
1. 单击[创建分身数字人模型训练任务](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/sdk?api=Create2dModelTrainingJob)，进入MetaStudio服务的API Explorer页面。
   
   参数"name"为数字人名称，其余参数的配置详见[创建分身数字人模型训练任务](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/sdk?api=Create2dModelTrainingJob)。
   参数配置完成后，单击"调试"，如果状态码返回200，说明接口调用成功。需要记录下返回字段job_id（任务ID）的值和上传链接。
   图1接口页面   
   ![](https://support.huaweicloud.com/api-metastudio/zh-cn_image_0000002383747224.png)
   
   
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上传文件   
   ![](https://support.huaweicloud.com/api-metastudio/zh-cn_image_0000002383435276.png)
   
   
3. 在左侧导航栏中选择"分身形象制作管理 \> [租户执行分身数字人模型训练任务命令](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/sdk?api=Execute2dModelTrainingCommandByUser)。
   
   请求体参数配置说明，如下所示，其余参数配置详见[租户执行分身数字人模型训练任务命令](https://support.huaweicloud.com/api-metastudio/Execute2dModelTrainingCommandByUser.html)。
   - job_id：第[1]步获取到的任务id。
   
   - command：命令类型。
   
   
   分几次调用接口，依次执行"CONFIRM_MULTIPART_UPLOADED"确认文件已上传、"SUBMITVERIFYING"提交任务。
   如果状态码返回200，并且响应体中的commond_result为EXCUTE_SUCCESS，说明命令执行成功。至此，模型训练任务创建动作完成。
   ![](https://support.huaweicloud.com/api-metastudio/public_sys-resources/notice_3.0-zh-cn.png)
   提交任务并在首次审核通过后不支持删除任务，测试用途请谨慎提交。
   图3接口页面   
   ![](https://support.huaweicloud.com/api-metastudio/zh-cn_image_0000002383759552.png)
   
   
4. （可选操作）前面3个步骤执行完成后，可以使用任务ID，通过[查询分身数字人模型训练任务详情](https://support.huaweicloud.com/api-metastudio/Show2dModelTrainingJob.html)接口查看任务进度。也可以在MetaStudio控制台的"任务中心 \> 分身形象制作"页面选择对应任务查看详情。
5. （可选操作）如果上传地址过期或审核不通过，可以获取更新任务相关文件的上传链接。 
   单击[更新分身数字人模型训练任务](https://console.huaweicloud.com/apiexplorer/#/openapi/MetaStudio/sdk?api=Update2dModelTrainingJob)，进入MetaStudio服务的API Explorer页面。
   请求体参数配置说明，如下所示，其余参数配置详见[更新分身数字人模型训练任务](https://support.huaweicloud.com/api-metastudio/Update2dModelTrainingJob.html)。
   - job_id：第[1]步获取的任务ID。
   
   - video_multipart_count：形象训练视频上传的分片数。
   
   
   单击"调试"，如果状态码返回200，说明接口调用成功。需要记录下返回的上传链接，按照第[2]步和第[3]步流程重新上传并提交。
   图4接口页面   
   ![](https://support.huaweicloud.com/api-metastudio/zh-cn_image_0000002417362033.png)
   
   
 
#### 常见错误
上传资产失败的常见错误，如下所示：
- 第[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则不支持抠像。