查询数字人名片制作任务详情 - ShowDigitalHumanBusinessCard

该接口用于查询数字人名片制作任务详情。

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

GET /v1/{project_id}/digital-human-business-cards/{job_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参考获取项目ID。
job_id	是	String	任务ID。

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取。响应消息头中X-Subject-Token的值。
Authorization	否	String	使用AK/SK方式认证时必选，携带的鉴权信息。
X-Sdk-Date	否	String	使用AK/SK方式认证时必选，请求的发生时间。格式为(YYYYMMDD'T'HHMMSS'Z')。
X-Project-Id	否	String	使用AK/SK方式认证时必选，携带项目ID信息。
X-App-UserId	否	String	第三方用户ID。不允许输入中文。

状态码：200

表3 响应Header参数
参数	参数类型	描述
X-Request-Id	String	请求ID。

表4 响应Body参数
参数	参数类型	描述
job_info	DigitalHumanBusinessCardJobInfo object	数字人名片制作任务信息。
card_templet_asset_id	String	数字人名片模板资产ID，可以从资产库中查询。
card_text_config	BusinessCardTextConfig object	用户输入的数字人名片信息。实际可以填写哪些字段取决于名片模板。
card_image_url	BusinessCardImageUrl object	用于制作数字人名片的图片下载URL。
introduction_type	String	自我介绍驱动方式。 TEXT: 文本驱动，即通过TTS合成语音 AUDIO: 语音驱动，需要在资产库中先上传语音资产默认取值： TEXT
introduction_text	String	自我介绍文本，用于驱动数字人口型。
voice_asset_id	String	音色资产ID，可以从资产库中查询。
introduction_audio_asset_id	String	自我介绍语音资产ID，用于驱动数字人口型。说明：介绍语音需要作为asset_type=AUDIO资产先上传至资产库。使用时从资产库中查询。
gender	String	性别。 MALE：男性 FEMALE：女性

表5 DigitalHumanBusinessCardJobInfo
参数	参数类型	描述
job_id	String	任务ID。
state	String	任务的状态。 WAITING: 等待 PROCESSING: 处理中 SUCCEED: 成功 FAILED: 失败 CANCELED: 取消 BLOCK: 冻结
start_time	String	数字人名片制作开始时间。
end_time	String	数字人名片制作结束时间。
output_asset_config	OutputAssetInfo object	输出资产信息配置。
error_info	ErrorResponse object	错误信息。
create_time	String	任务创建时间。
lastupdate_time	String	任务更新时间。
business_card_type	String	数字人名片类型。 2D_DIGITAL_HUMAN_CARD：分身数字人名片

表6 OutputAssetInfo
参数	参数类型	描述
asset_id	String	输出视频资产ID。
asset_name	String	输出视频资产名称。
cover_url	String	视频封面URL。
preview_video_url	String	预览视频下载URL。URL有效期24小时。说明：分身数字人视频制作不支持预览。

表7 ErrorResponse
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

表9 BusinessCardImageUrl
参数	参数类型	描述
human_image_url	String	任务照片下载URL。
logo_image	String	Logo图片下载URL。

状态码：400

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

状态码：401

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

状态码：404

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

状态码：500

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

GET https://{endpoint}/v1/70b76xxxxxx34253880af501cdxxxxxx/digital-human-business-cards/26f06524-4f75-4b3a-a853-b649a21aaf66

状态码：400

请求传参异常，包含错误码及对应描述。

{
  "error_code" : "MSS.00000003",
  "error_msg" : "Invalid parameter"
}

状态码：401

未鉴权或鉴权失败。

{
  "error_code" : "MSS.00000001",
  "error_msg" : "Unauthorized"
}

状态码：404

无内容。

{
  "error_code" : "MSS.00000002",
  "error_msg" : "Not Found"
}

状态码：500

内部服务错误。

{
  "error_code" : "MSS.00000004",
  "error_msg" : "Internal Error"
}