Sections de la documentation

Calculateur de performance moteur BLDC

POSThttps://rftools.io/api/py/v1/calculate

Slug bldc-motor. Calculateur de moteur BLDC : entrez la puissance nominale et la tension en Kv pour obtenir le régime à vide, le couple de décrochage, le point d'efficacité maximal et la poussée de l'hélice. Supporte les calculs liés aux drones, à la radiocommande et aux bobinages industriels.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de bldc-motor
Nom	Unité	Plage	Valeur par défaut	Description
kvRatingnombre	RPM/V	au moins 1	1000	Constante de vitesse du moteur — tr/min par volt à vide
voltagenombre	V	au moins 0.1	12	Tension de fonctionnement
motorResistancenombre	mΩ	au moins 0.1	50	Résistance d'enroulement phase-phase à partir de la fiche technique
noLoadCurrentnombre	A	au moins 0.001	0.5	Courant à vide (pertes en fer, frottement) d'après la fiche technique
propDiameternombre	inch	au moins 0.5	5	Diamètre de l'hélice pour l'estimation de la poussée (multirotor)

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de bldc-motor
Champ	Unité	Description
noLoadRpmprincipale	RPM	RPM à vide
stallCurrent	A	Courant de blocage
ktMnm	mNm/A	Constante de couple
stallTorque	Nm	Couple de blocage
maxEfficiency	%	Efficacité maximale
inputPower	W	Puissance d'entrée à efficacité maximale
thrust	g	Poussée estimée
loadedRpm	RPM	Vitesse en charge
loadedCurrent	A	Courant en charge

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "bldc-motor",
    "inputs": {
      "kvRating": 1000,
      "voltage": 12,
      "motorResistance": 50,
      "noLoadCurrent": 0.5,
      "propDiameter": 5
    }
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

result = client.calculate("bldc-motor", {
    "kvRating": 1000,
    "voltage": 12,
    "motorResistance": 50,
    "noLoadCurrent": 0.5,
    "propDiameter": 5,
})
print(result.values)
print(result.warnings, result.provenance.formula_ref)

const response = await fetch("https://rftools.io/api/py/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "bldc-motor",
    "inputs": {
      "kvRating": 1000,
      "voltage": 12,
      "motorResistance": 50,
      "noLoadCurrent": 0.5,
      "propDiameter": 5
    }
  }),
});
console.log(response.status, await response.json());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "slug": "bldc-motor",
	  "inputs": {
	    "kvRating": 1000,
	    "voltage": 12,
	    "motorResistance": 50,
	    "noLoadCurrent": 0.5,
	    "propDiameter": 5
	  }
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

application/json

{
  "slug": "bldc-motor",
  "values": {
    "noLoadRpm": 12000,
    "stallCurrent": 240,
    "ktMnm": 9.549296585513721,
    "stallTorque": 2.291831180523293,
    "maxEfficiency": 91.07962404158056,
    "inputPower": 131.45341380123986,
    "thrust": 140.90532398081277,
    "loadedRpm": 11912.515006913327,
    "loadedCurrent": 1.7496998617334896
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:bldc-motor",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Drela, First-Order DC Electric Motor Model (MIT, 2007); UIUC Propeller Data Site, Vol. 2, GWS Direct Drive 5×3 static data (gwsdd_5x3_static_0323rd.txt); Brandt & Selig, Propeller Performance Data at Low Reynolds Numbers, AIAA 2011-1255",
    "assumptions": [
      {
        "code": "static-thrust-coefficient",
        "text": "Thrust uses a static thrust coefficient C_T = 0.11, from the UIUC Propeller Data Site static data of a GWS Direct Drive 5×3 (C_T 0.102–0.113) and inside the 0.08–0.15 range published for small two-blade propellers, with sea-level air at 1.225 kg/m³."
      },
      {
        "code": "motor-propeller-balance",
        "text": "The propeller turns where the motor's torque (I − I₀)/K_v (Drela 2007) equals the propeller's C_P·ρ·n²·D⁵/(2π), with C_P = 0.047 from the same propeller's static data; every propeller is taken to have these coefficients."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "kvRating": {
          "min": 1,
          "max": null,
          "unit": "RPM/V"
        },
        "voltage": {
          "min": 0.1,
          "max": null,
          "unit": "V"
        },
        "motorResistance": {
          "min": 0.1,
          "max": null,
          "unit": "mΩ"
        },
        "noLoadCurrent": {
          "min": 0.001,
          "max": null,
          "unit": "A"
        },
        "propDiameter": {
          "min": 0.5,
          "max": null,
          "unit": "inch"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "kvRating": 1000,
      "voltage": 12,
      "motorResistance": 50,
      "noLoadCurrent": 0.5,
      "propDiameter": 5
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "kvRating"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de performance moteur BLDC, avec ces valeurs