Abschnitte der Dokumentation

Übersetzungsverhältnis-Rechner

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

Slug gear-ratio. Berechnen Sie das Übersetzungsverhältnis, die Ausgangsdrehzahl, die Drehmomentvervielfachung und den Wirkungsgrad der Kraftübertragung für Getriebe.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von gear-ratio
Name	Einheit	Bereich	Standardwert	Beschreibung
driverTeethZahl	teeth	mindestens 1	10	Treiberzähne (Eingabe)
drivenTeethZahl	teeth	mindestens 1	40	Angetriebene (Abtriebs-) Zähne
inputSpeedZahl	RPM	mindestens 0	1000	Eingangsgeschwindigkeit
inputTorqueZahl	N·m	mindestens 0	0.5	Eingangsdrehmoment
efficiencyZahl	%	10 … 100	95	Effizienz der Ausrüstung
extraStagesZahl	keine	0 … 5	0	Getriebestufen zwischen Eingangswelle und Ausgangspaar, vom Eingang aus gezählt (0–5)
stage1DriverZahl	teeth	1 … 1000	12	Zähne (oder Schneckengänge) am Antriebsrad von Stufe 1
stage1DrivenZahl	teeth	1 … 1000	36	Zähne am Abtriebsrad von Stufe 1
stage1EfficiencyZahl	%	10 … 100	98	Verzahnungswirkungsgrad der Stufe 1
stage2DriverZahl	teeth	1 … 1000	12	Zähne (oder Schneckengänge) am Antriebsrad von Stufe 2
stage2DrivenZahl	teeth	1 … 1000	36	Zähne am Abtriebsrad von Stufe 2
stage2EfficiencyZahl	%	10 … 100	98	Verzahnungswirkungsgrad der Stufe 2
stage3DriverZahl	teeth	1 … 1000	12	Zähne (oder Schneckengänge) am Antriebsrad von Stufe 3
stage3DrivenZahl	teeth	1 … 1000	36	Zähne am Abtriebsrad von Stufe 3
stage3EfficiencyZahl	%	10 … 100	98	Verzahnungswirkungsgrad der Stufe 3
stage4DriverZahl	teeth	1 … 1000	12	Zähne (oder Schneckengänge) am Antriebsrad von Stufe 4
stage4DrivenZahl	teeth	1 … 1000	36	Zähne am Abtriebsrad von Stufe 4
stage4EfficiencyZahl	%	10 … 100	98	Verzahnungswirkungsgrad der Stufe 4
stage5DriverZahl	teeth	1 … 1000	12	Zähne (oder Schneckengänge) am Antriebsrad von Stufe 5
stage5DrivenZahl	teeth	1 … 1000	36	Zähne am Abtriebsrad von Stufe 5
stage5EfficiencyZahl	%	10 … 100	98	Verzahnungswirkungsgrad der Stufe 5

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von gear-ratio
Feld	Einheit	Beschreibung
gearRatioHauptwert	:1	Übersetzungsverhältnis
outputSpeed	RPM	Ausgangsgeschwindigkeit
outputTorque	N·m	Ausgangsdrehmoment
inputPower	W	Eingangsleistung
outputPower	W	Ausgangsleistung
totalEfficiency	%	Gesamtwirkungsgrad

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "gear-ratio",
    "inputs": {
      "driverTeeth": 10,
      "drivenTeeth": 40,
      "inputSpeed": 1000,
      "inputTorque": 0.5,
      "efficiency": 95,
      "extraStages": 0,
      "stage1Driver": 12,
      "stage1Driven": 36,
      "stage1Efficiency": 98,
      "stage2Driver": 12,
      "stage2Driven": 36,
      "stage2Efficiency": 98,
      "stage3Driver": 12,
      "stage3Driven": 36,
      "stage3Efficiency": 98,
      "stage4Driver": 12,
      "stage4Driven": 36,
      "stage4Efficiency": 98,
      "stage5Driver": 12,
      "stage5Driven": 36,
      "stage5Efficiency": 98
    }
  }'

import rftools

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

result = client.calculate("gear-ratio", {
    "driverTeeth": 10,
    "drivenTeeth": 40,
    "inputSpeed": 1000,
    "inputTorque": 0.5,
    "efficiency": 95,
    "extraStages": 0,
    "stage1Driver": 12,
    "stage1Driven": 36,
    "stage1Efficiency": 98,
    "stage2Driver": 12,
    "stage2Driven": 36,
    "stage2Efficiency": 98,
    "stage3Driver": 12,
    "stage3Driven": 36,
    "stage3Efficiency": 98,
    "stage4Driver": 12,
    "stage4Driven": 36,
    "stage4Efficiency": 98,
    "stage5Driver": 12,
    "stage5Driven": 36,
    "stage5Efficiency": 98,
})
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": "gear-ratio",
    "inputs": {
      "driverTeeth": 10,
      "drivenTeeth": 40,
      "inputSpeed": 1000,
      "inputTorque": 0.5,
      "efficiency": 95,
      "extraStages": 0,
      "stage1Driver": 12,
      "stage1Driven": 36,
      "stage1Efficiency": 98,
      "stage2Driver": 12,
      "stage2Driven": 36,
      "stage2Efficiency": 98,
      "stage3Driver": 12,
      "stage3Driven": 36,
      "stage3Efficiency": 98,
      "stage4Driver": 12,
      "stage4Driven": 36,
      "stage4Efficiency": 98,
      "stage5Driver": 12,
      "stage5Driven": 36,
      "stage5Efficiency": 98
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "gear-ratio",
	  "inputs": {
	    "driverTeeth": 10,
	    "drivenTeeth": 40,
	    "inputSpeed": 1000,
	    "inputTorque": 0.5,
	    "efficiency": 95,
	    "extraStages": 0,
	    "stage1Driver": 12,
	    "stage1Driven": 36,
	    "stage1Efficiency": 98,
	    "stage2Driver": 12,
	    "stage2Driven": 36,
	    "stage2Efficiency": 98,
	    "stage3Driver": 12,
	    "stage3Driven": 36,
	    "stage3Efficiency": 98,
	    "stage4Driver": 12,
	    "stage4Driven": 36,
	    "stage4Efficiency": 98,
	    "stage5Driver": 12,
	    "stage5Driven": 36,
	    "stage5Efficiency": 98
	  }
	}`)
	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": "gear-ratio",
  "values": {
    "gearRatio": 4,
    "outputSpeed": 250,
    "outputTorque": 1.9,
    "inputPower": 52.35987755982988,
    "outputPower": 49.74188368183839,
    "totalEfficiency": 95
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:gear-ratio",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "driverTeeth": {
          "min": 1,
          "max": null,
          "unit": "teeth"
        },
        "drivenTeeth": {
          "min": 1,
          "max": null,
          "unit": "teeth"
        },
        "inputSpeed": {
          "min": 0,
          "max": null,
          "unit": "RPM"
        },
        "inputTorque": {
          "min": 0,
          "max": null,
          "unit": "N·m"
        },
        "efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "extraStages": {
          "min": 0,
          "max": 5,
          "unit": ""
        },
        "stage1Driver": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage1Driven": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage1Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "stage2Driver": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage2Driven": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage2Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "stage3Driver": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage3Driven": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage3Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "stage4Driver": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage4Driven": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage4Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        },
        "stage5Driver": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage5Driven": {
          "min": 1,
          "max": 1000,
          "unit": "teeth"
        },
        "stage5Efficiency": {
          "min": 10,
          "max": 100,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "driverTeeth": 10,
      "drivenTeeth": 40,
      "inputSpeed": 1000,
      "inputTorque": 0.5,
      "efficiency": 95,
      "extraStages": 0,
      "stage1Driver": 12,
      "stage1Driven": 36,
      "stage1Efficiency": 98,
      "stage2Driver": 12,
      "stage2Driven": 36,
      "stage2Efficiency": 98,
      "stage3Driver": 12,
      "stage3Driven": 36,
      "stage3Efficiency": 98,
      "stage4Driver": 12,
      "stage4Driven": 36,
      "stage4Efficiency": 98,
      "stage5Driver": 12,
      "stage5Driven": 36,
      "stage5Efficiency": 98
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

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

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteÜbersetzungsverhältnis-Rechner, mit diesen Werten