Drone Flight Time Calculator · Schema
Raw schema.
Same JSON the GET /v1/drones-uav/drone-flight-time-calculator/schema endpoint returns — formatted for reading. Use it to codegen typed clients or document the contract.
{ "tool": "drone-flight-time-calculator", "domain": "drones-uav", "version": "1.0.0", "name": "Drone Flight Time Calculator", "description": "Realistic flight-time estimate for any multirotor — uses hover efficiency (g/W), pack voltage, ESC efficiency, usable-capacity derating and a flight-style multiplier instead of the naive mAh ÷ current formula.", "standard": null, "inputs": [ { "key": "auw_grams", "label": "All-Up Weight (AUW)", "required": true, "unit": "g", "help": "Total flying weight including battery, camera, GPS, antennas — everything that leaves the ground.", "type": "number", "min": 20, "max": 50000, "step": 10, "default": 680 }, { "key": "battery_capacity_mah", "label": "Battery Capacity", "required": true, "unit": "mAh", "type": "number", "min": 100, "max": 50000, "step": 50, "default": 1500 }, { "key": "battery_cells_s", "label": "Battery Cells", "required": true, "help": "Series cell count. 4S = 14.8 V nominal, 6S = 22.2 V nominal. Higher S means more voltage, less current for the same power.", "type": "enum", "options": [ "2", "3", "4", "5", "6", "7", "8", "10", "12" ], "default": "4" }, { "key": "hover_efficiency_g_per_w", "label": "Hover Efficiency", "required": true, "unit": "g/W", "help": "Grams of static thrust produced per watt at the hover point. Tinywhoop ~3, 5\" race ~5, 5\" cinematic ~7, 7\" long-range ~9, 10\" cinelifter ~11. Pull from your motor manufacturer's thrust table.", "type": "number", "min": 1, "max": 20, "step": 0.1, "default": 6 }, { "key": "flight_style", "label": "Flight Style", "required": true, "help": "Determines the average power above hover. Hover-only is the upper bound, racing the lower.", "type": "enum", "options": [ "hover", "cinematic", "freestyle", "racing" ], "default": "cinematic" }, { "key": "usable_capacity_pct", "label": "Usable Capacity", "required": true, "unit": "%", "help": "Fraction of nameplate capacity you actually use before landing. Landing at 3.5 V/cell typically leaves ~80% usable; 3.7 V/cell leaves ~70%.", "type": "number", "min": 40, "max": 100, "step": 1, "default": 80 }, { "key": "esc_efficiency_pct", "label": "ESC Efficiency", "required": true, "unit": "%", "help": "Combined motor + ESC electrical efficiency. Modern BLHeli_32 + quality motors hover around 90–94%.", "type": "number", "min": 70, "max": 99, "step": 1, "default": 92 } ], "outputs": [ { "key": "pack_voltage_nominal_v", "label": "Pack Voltage (nominal)", "type": "number", "unit": "V", "precision": 2 }, { "key": "pack_energy_wh", "label": "Pack Energy", "type": "number", "unit": "Wh", "precision": 1 }, { "key": "usable_energy_wh", "label": "Usable Energy", "type": "number", "unit": "Wh", "precision": 1 }, { "key": "hover_power_w", "label": "Hover Power", "type": "number", "unit": "W", "precision": 1 }, { "key": "hover_current_a", "label": "Hover Current", "type": "number", "unit": "A", "precision": 1 }, { "key": "avg_power_w", "label": "Average Power", "type": "number", "unit": "W", "precision": 1 }, { "key": "flight_time_minutes", "label": "Flight Time", "type": "number", "unit": "min", "precision": 1 }, { "key": "min_pack_c_continuous", "label": "Min Pack C (Continuous)", "type": "number", "unit": "C", "precision": 1 }, { "key": "style_multiplier", "label": "Style Multiplier", "type": "number", "unit": "x", "precision": 2 } ], "endpoint": "/v1/drones-uav/drone-flight-time-calculator" }