---
title: "Start Reconstruction Task"
method: POST
path: "/openapi/v2.0/open_model/models/reconstruction/start"
tags: ["Open Modeling"]
---

# Start Reconstruction Task

`POST /openapi/v2.0/open_model/models/reconstruction/start`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/open_model/models/reconstruction/start`
- Auth: none required

1. Start a reconstruction task. Used to start a reconstruction task; multiple model types can be built simultaneously, but at least one `parameter_` parameter is required.
2. For the mapping image count consumption per task, please refer to the official website. If the modeling task fails, the consumed mapping image count will be returned.
3. Each modeling task type has file count limits:
- 2d: min 5, max 20,000 photos
- 3d: min 5, max 20,000 photos
- 3dgs: min 10, max 4,000 photos
- lidar: min 5, max 20,000 photos
4. Maximum concurrent task count limits:
- Standard: 2
- Professional: 5
- Enterprise: 10
5. 2d/3d/3dgs modeling only uses images from the resource. Lidar modeling uses files including but not limited to images; please ensure the resource contains the necessary lidar-related files.
6. Please ensure image coverage, and use photos taken by supported DJI UAVs. For the list of supported UAV types, refer to the official website.

## Headers

- `X-Request-Id` string, uuid
- `X-User-Token` string, required
- `X-Language` string

## Request body

- object
  - `resource_uuid` string, required: Resource UUID, used to specify the resource for this reconstruction
  - `parameter_2d` string: JSON string, max 16384 characters
  - `parameter_3d` string: JSON string, max 16384 characters
  - `parameter_3dgs` string: JSON string, max 16384 characters
  - `parameter_lidar` string: JSON string, max 16384 characters
  - `delete_resource_if_finish` boolean: If true, the resource will be automatically deleted after all tasks under the resource have completed

## Response `200`

- object
  - `code` integer, required: Business status code, 0 means success
  - `message` string, required: Business Message
  - `data` object, required: Business Data
    - `model_2d` object, required: 2D Model Reconstruction Task Info
      - `uuid` string, required: Model UUID
      - `status` integer, required: Model status, see interface description for enum
      - `sub_error_code` integer, required: Sub error code, 0 means no error
    - `model_3d` object, required: 3D Model Reconstruction Task Info
      - `uuid` string, required: Model UUID
      - `status` integer, required: Model status, see interface description for enum
      - `sub_error_code` integer, required: Sub error code, 0 means no error
    - `model_3dgs` object, required: 3DGS Model Reconstruction Task Info
      - `uuid` string, required: Model UUID
      - `status` integer, required: Model status, see interface description for enum
      - `sub_error_code` integer, required: Sub error code, 0 means no error
    - `model_lidar` object, required: Lidar Model Reconstruction Task Info
      - `uuid` string, required: Model UUID
      - `status` integer, required: Model status, see interface description for enum
      - `sub_error_code` integer, required: Sub error code, 0 means no error

## Other responses

- `400`: Invalid request parameters (incorrect format, missing required fields, etc.)
- `401`: Authentication failed (token invalid or expired)
- `403`: Insufficient permission (token does not have the corresponding permission in this project/organization)
- `500`: Server Internal Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)