# Alibaba Cloud 3D space reconstruction API

> Alibaba Cloud 3D space reconstruction API on Apizie: 68 endpoints (Saves a model file, Applies a mosaic to a custom area, Creates a new project, Submits house data generated by mobile algorithms to the cloud for 3D model reconstruction, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-tdsr`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/tdsr
- Page: https://zieapi.vercel.app/api/cloud/aliyun-tdsr
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-tdsr/openapi.json

Alibaba Cloud OpenAPI for 3D space reconstruction (tdsr, version 2020-01-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Saves a model file
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-hotspot-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |
| FileName | string | yes | The file name |
| Type | string | yes | The file type |

### Applies a mosaic to a custom area
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-mosaics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |
| MarkPosition | string | yes | The mosaic position data |

### Creates a new project
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| BusinessId | integer | no | The business ID. Default value: 5 (unassigned project). Do not specify this parameter unless necessary |
| Name | string | yes | The name of the project |

### Submits house data generated by mobile algorithms to the cloud for 3D model reconstruction
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-room-plan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Creates a main scene of a specific type
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Type | string | yes | The scene type. Valid values: MODEL_3D for 3D models, PIC for panoramic images, VIDEO for panoramic videos, and MIX for mixed scenes |
| Name | string | yes | The name of the scene |
| ProjectId | string | yes | The ID of the project |
| CustomerUid | string | no | The UID of the business party |

### Adds a new sub-scenario under a specified main scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-sub-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scenario ID |
| Name | string | yes | The name of the sub-scenario. The name must be 1 to 20 characters in length |
| UploadType | string | no | The upload type. Valid values: IMAGE and VIDEO |

### Checks whether a user has the specified business attribute
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/check-user-property` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Uid | string | yes | The UID of the user |

### Copies an existing scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/copy-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scenario ID |
| SceneName | string | yes | The name of the new scenario |
| ProjectId | string | no | The ID of the project to which the scenario is copied. If this parameter is left empty, the scenario is copied to the project where the… |

### Retrieves upload credentials
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/create-upload-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Type | string | yes | The upload type. Valid values: scene, subScene, and hotspot |
| Option | string | yes | The type-specific parameters |

### Queries the basic information of a project
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/detail-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The project ID |

### Retrieves information about a specified main scene
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/detail-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The scene ID |

### Queries the details of a sub-scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/detail-sub-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The encrypted ID of the sub-scenario |

### Deletes an existing project. Projects that contain published scenarios cannot be deleted
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/drop-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| ProjectId | string | yes | The project ID |

### Deletes a specified primary scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/drop-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The ID of the primary scenario |

### Deletes a specified sub-scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/drop-sub-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The sub-scenario ID |

### Retrieves association information for annotation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-conn-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Queries the status of a replication scenario task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-copy-scene-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| TaskId | string | yes | The task ID |

### Queries the hotspot annotation configuration for post-processing
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-hotspot-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PreviewToken | string | yes | The preview token |
| Type | integer | yes | Valid values: 0: Unpublished. 1: Published |
| Enabled | string | no | Specifies whether to enable access to self-used resources. This must be enabled before publishing the scenario |
| Domain | string | no | The custom Object Storage Service (OSS) domain name. This can be a Content Delivery Network (CDN) domain name |

### Queries the preview data of a scene model based on a preview token
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-hotspot-scene-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PreviewToken | string | yes | The preview token |
| Type | integer | yes | The type. Valid values: 0: Unpublished. 1: Published |
| Domain | string | no | The custom OSS domain name. You can also specify a CDN domain name |
| Enabled | string | no | Specifies whether to enable access to self-owned resources |

### Retrieves hotspot annotation information for post-processing
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-hotspot-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PreviewToken | string | no | The preview token |
| SubSceneUuid | string | no | The sub-scene UUID |
| Type | string | no | The type. Valid values: 0: Unpublished. 1: Published |
| Enabled | string | no | Specifies whether access to self-owned resources is enabled |
| Domain | string | no | The custom OSS domain name, which can be a CDN domain name |

### Retrieves the latest annotation information for use during annotation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-layout-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scenario ID |

### Retrieves the original annotation information. This operation can be used with the update annotation…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-origin-layout-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |

### Obtains Object Storage Service (OSS) authorization. After obtaining the authorization, you can use the OSS…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-oss-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The ID of the sub-scene |

### Queries the data packaging status of a scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-pack-scene-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| TaskId | string | yes | The task ID |
| Type | string | yes | The operation type. Valid values: download: Download. sync: Synchronization |

### Retrieves the vertically corrected image
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-rectify-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |

### Queries the status of a scene reconstruction task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-scene-build-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Retrieves the download URL of the data package after the PackScene operation is called
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-scene-pack-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Retrieves scene preview data for model rendering
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-scene-preview-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PreviewToken | string | yes | The preview token |
| Domain | string | no | The custom OSS domain name, which can be a CDN domain name |
| Enabled | string | no | Specifies whether to enable access to self-owned resources. Default value: false |
| ShowTag | string | no | Specifies whether to return hotspot data. Default value: false |

### Retrieves the point information of a scene model
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-scene-preview-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| ModelToken | string | yes | The model token |
| Domain | string | no | The custom OSS domain name, which can be a CDN domain name |
| Enabled | string | no | Specifies whether to enable access to self-owned resources |

### Previews model scenarios
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-scene-preview-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PreviewToken | string | yes | The preview token |
| Draft | string | no | Specifies whether to preview the draft. Valid values: true and false. Default value: false. This parameter is used to preview the scenario… |

### Retrieves the association information for a single map
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-single-conn-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |

### Retrieves the packaging status of the panorama file
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-source-pack-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| TaskId | string | yes | The task ID |

### Queries the preprocessing and image slicing status of a sub-scene
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-sub-scene-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The ID of the sub-scene |

### Queries the status of a task of any type
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| TaskId | string | yes | The task ID |

### Retrieves system configuration information for use in preview and post-processing
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/get-window-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PreviewToken | string | no | The preview token |

### Reconstructs a 3D model
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/label-build` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |
| Mode | string | no | The reconstruction mode. Valid values: MANUAL: manual. This value is used only when you use the annotation tool for reconstruction. This… |
| WallHeight | integer | no | The wall height. Default value: 0, which indicates that the wall height is not set. Valid values: 200 to 1000. Unit: cm |
| OptimizeWallWidth | string | no | The wall width optimization mode. Valid values: OFF: disabled. This is the default value. NORMAL: standard. ENHANCED: enhanced |
| ModelStyle | string | no | The model style. Valid values: PATCH: patch model. This is the default value. DEPTH: depth model |
| PlanStyle | string | no | The floor plan style. Valid values: DEFAULT: default. This is the default value. STANDARD: standard |

### Associates an image or a video with a sub-scene. Currently, only one image or one video can be associated…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/link-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The ID of the sub-scene |
| FileName | string | yes | The name of the image or video, such as ****.jpg or ****.mp4 |
| CameraHeight | integer | no | The height of the camera. Unit: cm |
| Platform | string | no | The platform identifier. Valid values: PC and MOBILE. Default value: PC |

### Queries a paginated list of all projects
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/list-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| PageNum | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |
| Name | string | no | The project name. Use name% for fuzzy search |

### Retrieves a list of all main scenes under a specified project
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/list-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Name | string | no | The name of the main scene |
| ProjectId | string | yes | The ID of the project |
| PageNum | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |

### Queries a paginated list of sub-scenes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/list-sub-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID (encrypted) |
| PageNum | integer | yes | The page number |
| PageSize | integer | yes | The page size |
| ShowLayoutData | string | no | Specifies whether to return annotation data |
| SortField | string | no | The field used for sorting. Valid values: NAME (name) and SEQUENCE (custom sequence). Default value: NAME |

### Optimizes wall intersections to right angles
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/optimize-right-angle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |

### Packages scenario data. If the type parameter is set to download, the data is downloaded to your local…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/pack-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |
| Type | string | yes | The operation type. Valid values: download: Downloads the data. sync: Synchronizes the data |

### Retrieves all panoramic images for the 3D model type
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/pack-source` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Preprocesses images, including vertical correction, wall line prediction, and door prediction. You can call…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/pred-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |
| DetectDoor | string | yes | Specifies whether to predict doors |
| CountDetectDoor | integer | no | The number of doors |
| CorrectVertical | string | yes | Specifies whether to perform vertical correction |

### Predicts wall lines and returns a task ID and a sub-scene ID. You can query the task status by using the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/prediction-wall-line` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Url | string | yes | The URL of the image |
| CameraHeight | integer | no | The height of the camera. Unit: cm |

### Publishes hot spot information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/publish-hotspot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| ParamTag | string | no | The hot spot tag data |
| SubSceneUuid | string | no | The ID of the sub-scenario |

### Publishes the hot spot configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/publish-hotspot-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Publishes a scene
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/publish-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Queries the publish status
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/publish-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Restores a mosaic image to its original state
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/recovery-origin-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |

### Corrects images vertically in a specified sub-scene and removes the sub-scene association after the correction
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/rect-vertical` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |
| VerticalRect | string | yes | The correction data |
| DetectDoor | string | no | Specifies whether to enable door prediction |
| CountDetectDoor | integer | no | The number of doors to predict. This parameter takes effect only when DetectDoor is set to true |

### Corrects the vertical perspective of the input image
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/rectify-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Url | string | yes | The URL of the image |
| CameraHeight | integer | no | The height of the camera. Unit: cm |

### Restores a deleted sub-scenario in a panoramic scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/rollback-sub-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The ID of the sub-scenario |

### Saves the hotspot annotation configuration for use in post-processing
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/save-hotspot-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| ParamTag | string | no | The configuration information |
| PreviewToken | string | no | The preview token |

### Saves hotspot annotation information for use in post-processing
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/save-hotspot-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| ParamTag | string | no | The hotspot tag data |
| SubSceneUuid | string | no | The sub-scene ID |

### Saves hot spot data
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/save-hotspot-tag-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |
| HotspotListJson | string | yes | The hot spot data as a JSON string array |

### Saves minimap data
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/save-minimap` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |
| Data | string | yes | The minimap data in JSON string format |

### Saves the model configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/save-model-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Data | string | yes | The model configuration as a JSON string |
| SceneId | string | yes | The scenario ID |

### Publishes a scene
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/scene-publish` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Retrieves the preview URL after a rebuild
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/temp-preview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The ID of the primary scene |

### Queries the status of a preview task. You can call this operation to check the task status after calling…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/temp-preview-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |

### Updates association information for annotation and saves the latest association data
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/update-conn-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The scene ID |
| ConnData | string | yes | The association data |

### Updates annotation information. You can use this operation to save the annotation information after annotation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/update-layout-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SubSceneId | string | yes | The sub-scene ID |
| LayoutData | string | yes | The annotation data |

### Updates the information of a specified project
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/update-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The project ID |
| Name | string | no | The project name |
| BusinessId | string | no | The business ID |

### Updates the name of a scenario
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/update-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The scenario ID |
| Name | string | yes | The scenario name |

### Updates the information of the specified sub-scene
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/update-sub-scene` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| Id | string | yes | The ID of the sub-scene |
| Name | string | no | The name of the sub-scene. The value must match the regular expression ^[0-9a-zA-Z_-\u4e00-\u9fa5]{1,20}$ |
| ViewPoint | string | no | The viewpoint coordinates. Both 3-element and 4-element coordinates are supported. Example: [0.94005,0.13397,-0.3136,0.782992]… |

### Previews the order of sub-scenes on a page
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/update-sub-scene-seq` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |
| SceneId | string | yes | The ID of the sub-scene |
| SortSubSceneIds | string | yes | The array of sub-scene IDs for sorting (JSON-encoded) |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://lyj.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-hotspot-file" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud 3D space reconstruction API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-tdsr/add-hotspot-file with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud 3D space reconstruction API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud 3D space reconstruction itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud 3D space reconstruction API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-tdsr.

### What is the status of the Alibaba Cloud 3D space reconstruction API?
Needs your own provider key (bring your own key)