文档首页/ 数字内容生产线 MetaStudio/ API参考/ 3D数字人/ 3D数字人风格化照片建模/ 创建照片建模任务
更新时间：2024-11-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建照片建模任务

功能介绍

该接口用于创建风格化照片建模任务。使用BASE64编码照片，通过JSON格式上传，生成风格化数字人模型。

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/digital-human/stylized/picture-modelings-by-json

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目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。不允许输入中文。
表3 请求Body参数

参数

是否必选

参数类型

描述

picture_base64

是

String

图片BASE64编码后内容

style_id

是

String

风格ID

name

是

String

模型名称

notify_url

否

String

照片建模任务结束的回调地址。

响应参数

状态码： 200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

请求ID。
表5 响应Body参数

参数

参数类型

描述

job_id

String

任务ID。

model_asset_id

String

数字人资产ID。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

BadRequest

AnyType

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

状态码： 401

表7 响应Body参数

参数

参数类型

描述

Unauthorized

AnyType

未鉴权或鉴权失败。

状态码： 403

表8 响应Body参数

参数

参数类型

描述

Forbidden

AnyType

未授权。

状态码： 500

表9 响应Body参数

参数

参数类型

描述

InternalServiceError

AnyType

内部服务错误。

请求示例

POST https://metastudio.cn-east-3.myhuaweicloud.com/v1/f488337c31c8e4622f1590735b134c65/picture-modelings-by-json

{
  "picture_base64" : "/9j/4QfweFWEgrGhehQewfFWEkqAAgAAAAL....",
  "style_id" : "system_female_001",
  "name" : "my_model"
}

响应示例

状态码： 200

创建任务请求已接受

{
  "job_id" : "6eb78b2f-6ba2-4b59-bb07-d2fc372f8d39",
  "model_asset_id" : "89026ecafff64514e3e4b225f228bc0d"
}

状态码： 400

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

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

状态码： 401

未鉴权或鉴权失败。

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

状态码： 403

未授权。

{
  "error_code" : "MSS.00000005",
  "error_msg" : "Forbidden"
}

状态码： 500

内部服务错误。

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

状态码

状态码

描述

200

创建任务请求已接受

400

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

401

未鉴权或鉴权失败。

403

未授权。

500

内部服务错误。

错误码

请参见错误码。

父主题： 3D数字人风格化照片建模

相关文档