本文介绍3D视觉（threedvision）类目下的图像人体重建ReconstructBodyBySingleImage的语法及示例。
服务说明
3D视觉服务将于2023年2月24日起停止更新，后续不再支持新用户开通接入服务。2023年2月24日之后，会继续支持已开通3D视觉服务的老用户使用，老用户如果对3D视觉服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
功能描述
图像人体重建能力可以从单张人体图像中估计出每个像素对应的三维深度值，并且输出对应视角下的局部单位网格模型。
关于该接口功能的示例图如下：
说明 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
应用场景
- 网络试衣：通过用户拍摄的一张照片建立起三维模型，将三维建模的衣服虚拟穿着在用户身上，让用户体验衣服真实的上身效果。
- 虚拟讲解和销售：将讲解员重建三维形象放置于VR展会、VR商店中，向客户介绍展品、商品，可快速实现带虚拟讲解和销售的VR场景，并减少构建3D人物所带来的大量成本。
特色优势
简便易用：通过一张照片即可还原出人体三维模型。
输入限制
- 图像格式：JPEG、JPG、PNG、BMP。
- 图像分辨率：输入图像建议分辨率512×512像素（宽×高），如果输入图像大小不是512×512像素，系统会自动调整至512×512像素。
- 图像大小：不超过5 MB。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ReconstructBodyBySingleImage | 系统规定参数。取值：ReconstructBodyBySingleImage。 |
| ImageURL | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxxx/test/yefeibg.png | 图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | D755F706-B33B-4F3B-8751-4707AD2CA15C | 请求ID。 |
| Data | Object | 返回的结果数据内容。 |
|
| DepthURL | String | http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/HumanReconstruction/1ac0e56e-5138-40ea-a44d-05810b57c723/depth.npy | 返回预测的深度图的URL。 说明 .npy文件需要用Python NumPy加载读取。 |
| MeshURL | String | http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/HumanReconstruction/1ac0e56e-5138-40ea-a44d-05810b57c723/mesh.obj | 返回深度转Mesh结果的URL。 说明 .obj文件可以用MeshLab工具打开。 |
SDK参考
阿里云视觉AI3D视觉类目下的图像人体重建能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为3D视觉（threedvision）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。
示例
请求示例
http(s)://threedvision.cn-shanghai.aliyuncs.com/?Action=ReconstructBodyBySingleImage //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxxx/test/yefeibg.png
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ReconstructBodyBySingleImageResponse>
<RequestId>D755F706-B33B-4F3B-8751-4707AD2CA15C</RequestId>
<Data>
<DepthURL>http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/HumanReconstruction/1ac0e56e-5138-40ea-a44d-05810b57c723/depth.npy</DepthURL>
<MeshURL>http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/HumanReconstruction/1ac0e56e-5138-40ea-a44d-05810b57c723/mesh.obj</MeshURL>
</Data>
</ReconstructBodyBySingleImageResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "D755F706-B33B-4F3B-8751-4707AD2CA15C",
"Data" : {
"DepthURL" : "http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/HumanReconstruction/1ac0e56e-5138-40ea-a44d-05810b57c723/depth.npy",
"MeshURL" : "http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/HumanReconstruction/1ac0e56e-5138-40ea-a44d-05810b57c723/mesh.obj"
}
}错误码
关于图像人体重建的错误码，详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。