1. Open modeling
NEW FlightHub 2 OpenAPI V1.0
  • Root Directory
    • authentication
      • Authentication Tutorial
    • System Service
      • Query FlightHub 2 system status
    • Organize Projects
      • Organize Project Tutorial
      • Get the list of projects under the organization
      • Get the list of devices under the organization
      • Obtain the list of devices under the project
      • Obtain storage upload credentials for the project
      • Add personnel to the project
    • Device Management
      • Device Management Tutorial
      • Device Model Retrieval
      • HMS Information Retrieval
      • Real-time control command distribution
      • Dock camera switch
      • Aircraft Lens Switching
      • Control acquisition
      • Release control
      • Video transmission clarity settings
      • Custom Network RTK Calibration
    • Livestream Management
      • Livestream Management Tutorial
      • Livestream Push
        • Start livestream
      • Bypass Streaming
        • Stream forwarding error code
        • Create Stream Forwarder
        • Enable/Disable stream forwarder
        • Get stream transcoder list
        • Delete stream forwarder
    • Task Management
      • Task Management Tutorial
      • Create Flight Task
      • Updated flight task status
      • Obtain flight task list
      • Obtain media resources generated by the Flight task
      • Obtain Flight task trajectory information
      • Obtain Flight task information
    • Flight Route Management
      • Flight Route Management Tutorial
      • Flight Route Upload Completion Notification
      • Get the list of flight routes under the project
      • Get flight route details
    • Model Management
      • Model Management Tutorial
      • Model reconstruction coordinate system
      • Get the list of models under the project
      • Get Model Details
      • Model reconstruction
    • Annotation Management
      • Annotation Management Tutorial
      • Create map annotation
    • Open modeling
      • Open modeling tutorial
      • Release Notes
      • Model Reconstruction Error Code
      • Algorithm parameter introduction
      • Get resource details
        GET
      • Get Details of Models Currently Being Reconstructed
        GET
      • Get upload credential
        POST
      • Upload callback
        POST
      • Delete resource
        DELETE
      • Start reconstruction task
        POST
      • Stop reconstruction task
        POST
      • Get the Model Details
        GET
      • Delete Models
        DELETE
  1. Open modeling

Release Notes

Update Date: 2026-10-15#

Key Changes:
Added optimize_rolling_shutter to parameter_2d, enabling rolling-shutter (RS) compensation during reconstruction
Added optimize_rolling_shutter and weak_texture_optimization to parameter_3d, enabling RS compensation and weak-texture optimization respectively

1. Modeling Parameter Changes#

parameter_2d (2D Visible Light Reconstruction Parameters)#

Added Fields#

FieldTypeDefaultDescription
optimize_rolling_shutterboolfalseWhether to enable rolling-shutter (RS) compensation during reconstruction

parameter_3d (3D Visible Light Reconstruction Parameters)#

Added Fields#

FieldTypeDefaultDescription
weak_texture_optimizationboolfalseWhether to enable weak-texture optimization, which improves point cloud quality
optimize_rolling_shutterboolfalseWhether to enable rolling-shutter (RS) compensation during reconstruction

About RS (Rolling Shutter) High-Precision Reconstruction#

Photos captured by rolling-shutter (RS) cameras during high-speed flight or long flight lines are prone to a "jello effect" and geometric distortion, which degrades reconstruction precision. With optimize_rolling_shutter enabled:
High-precision aerotriangulation, 2D, and 3D reconstruction can be completed using RS photos;
RS photos can be imported together with global-shutter (GS) photos in the same job;
The rolling-shutter "jello effect" is effectively corrected, improving the precision of reconstruction output;
Previously captured RS data can be reused directly — there is no need to re-fly the mission.
Enabling this optimization improves reconstruction quality, at the cost of reduced reconstruction efficiency.
Precision reference: with a stable RTK signal, using an M4T flying at 60 m / 120 m altitude with photos captured via an area flight line, reconstruction with RS optimization enabled achieves roughly 3–4× GSD horizontal precision and 4–5× GSD vertical precision. For survey-grade high-precision reconstruction, a survey-grade aircraft such as the M4E is recommended instead.
Supported aircraft: M4T, M4TD, M5TD.

Update Date: 2026-05-07#

Key Changes:
Algorithm upgrade, supports L3 Reconstruction, LiDAR Reconstruction supports 3D Gaussian
API change, the Get Resource Details API will return the names of currently uploaded files
New API added, Get Details of Models Currently Being Reconstructed, retrieves details of tasks currently in progress

1. Modeling Parameter Changes#

parameter_lidar (LiDAR Reconstruction Parameters)#

Added Fields#

FieldTypeDefaultDescription
output_meshbooltrueWhether to generate 3D mesh output
generate_3dgsboolfalseWhether to generate 3DGS output
quality_level_3dgsenum_int1Reconstruction precision level. Allowed values: 1, 2, 4, representing: ultra-high quality, high quality, preview quality
generate_3dtilesbooltrueWhether to generate output in 3D Tiles format. 3D Tiles output can be used in third-party libraries based on Cesium. Disable this if not needed
generate_3dgs_dombooltrueWhether to generate a 2D map from the 3DGS output

Removed Fields#

FieldTypeDefaultDescription
lidar_point_max_distanceint300Maximum effective distance of LiDAR point cloud. Points beyond this distance will be cropped

parameter_3dgs (3DGS Visible Light Reconstruction Parameters)#

Added Fields#

FieldTypeDefaultDescription
generate_3dgs_dombooltrueWhether to generate a 2D map from the 3DGS output

parameter_3d (3D Visible Light Reconstruction Parameters)#

Removed Fields#

FieldTypeDefaultDescription
water_refineboolfalseWhether to enable water surface flattening. Recommended when the survey area contains large water bodies to be reconstructed

2. API Changes#

Get Resource Details#

Added Fields in Response#

FieldTypeDefaultDescription
file_namesarray[string][]May only have a value when the resource has not been deleted

3. New APIs#

Get Details of Models Currently Being Reconstructed#

Example Response#

{
    "code": 0,
    "message": "",
    "data": {
        "list": [
            {
                "resource_uuid": "14513788-a0c6-47e0-96d8-29736a44546a",
                "model_uuid": "49f7c6d3-6096-49d8-a856-8e932b0561fe",
                "model_type": 4,
                "model_status": 14,
                "model_size": 0,
                "reconstruction_progress": 1,
                "zip_status": 0,
                "zip_progress": 0
            }
        ]
    }
}
Previous
Open modeling tutorial
Next
Model Reconstruction Error Code
Built with