Drone Thrust-to-Weight & Hover Throttle · Schema
Raw schema.

Same JSON the GET /v1/drones-uav/drone-thrust-to-weight/schema endpoint returns — formatted for reading. Use it to codegen typed clients or document the contract.
← Back to tool docs Try it interactively Hit the live endpoint
drone-thrust-to-weight.schema.json
{
  "tool": "drone-thrust-to-weight",
  "domain": "drones-uav",
  "version": "1.0.0",
  "name": "Drone Thrust-to-Weight & Hover Throttle",
  "description": "Compute thrust-to-weight ratio and hover throttle for any multirotor using the correct square-law throttle ↔ thrust relationship — not the linear approximation most calculators get wrong. Recommends a motor thrust to hit a target TWR.",
  "standard": null,
  "inputs": [
    {
      "key": "auw_grams",
      "label": "All-Up Weight (AUW)",
      "required": true,
      "unit": "g",
      "help": "Total flying weight — frame, motors, ESC, FC, battery, camera, antennas. Everything that lifts off.",
      "type": "number",
      "min": 20,
      "max": 50000,
      "step": 10,
      "default": 680
    },
    {
      "key": "num_motors",
      "label": "Number of Motors",
      "required": true,
      "help": "4 for a quad, 6 for a hex, 8 for an octocopter or X8 coaxial.",
      "type": "enum",
      "options": [
        "3",
        "4",
        "6",
        "8"
      ],
      "default": "4"
    },
    {
      "key": "motor_max_thrust_g",
      "label": "Max Thrust per Motor",
      "required": true,
      "unit": "g",
      "help": "Static thrust at 100% throttle on the chosen prop and pack voltage — pull from the manufacturer's thrust table for that combination.",
      "type": "number",
      "min": 50,
      "max": 20000,
      "step": 10,
      "default": 800
    },
    {
      "key": "target_twr",
      "label": "Target Thrust-to-Weight",
      "required": true,
      "unit": ":1",
      "help": "Cinematic 2:1, sport / aerial 3:1, freestyle 4–5:1, racing 7–10:1. Below 2:1 the craft won't recover from descents.",
      "type": "number",
      "min": 1.2,
      "max": 15,
      "step": 0.1,
      "default": 4
    }
  ],
  "outputs": [
    {
      "key": "total_max_thrust_g",
      "label": "Total Max Thrust",
      "type": "number",
      "unit": "g",
      "precision": 0
    },
    {
      "key": "twr",
      "label": "Thrust-to-Weight",
      "type": "number",
      "unit": ":1",
      "precision": 2
    },
    {
      "key": "hover_throttle_pct",
      "label": "Hover Throttle (square-law)",
      "type": "number",
      "unit": "%",
      "precision": 1
    },
    {
      "key": "hover_throttle_linear_pct",
      "label": "Hover Throttle (linear approx)",
      "type": "number",
      "unit": "%",
      "precision": 1
    },
    {
      "key": "hover_thrust_per_motor_g",
      "label": "Hover Thrust / Motor",
      "type": "number",
      "unit": "g",
      "precision": 0
    },
    {
      "key": "recommended_motor_thrust_g",
      "label": "Recommended Motor Thrust",
      "type": "number",
      "unit": "g",
      "precision": 0
    },
    {
      "key": "twr_verdict",
      "label": "Verdict",
      "type": "string"
    }
  ],
  "endpoint": "/v1/drones-uav/drone-thrust-to-weight"
}