Abschnitte der Dokumentation

Audio-SNR und Dynamikbereich

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

Slug audio-snr. Berechnen Sie das Audio-SNR und den Dynamikbereich. 16-Bit-Audio = 98 dB, 24-Bit = 146 dB theoretisches SNR. Formel: SNR = 6,02 · N + 1,76 dB. Geben Sie die Bittiefe oder den Signal-/Rauschpegel in dBV ein.

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 audio-snr
Name	Einheit	Bereich	Standardwert	Beschreibung
signalLevelZahl	dBV	−80 … 30	0	Signalpegel
noiseFloorZahl	dBV	−140 … 0	-90	Grundrauschen
targetSnrZahl	dB	0 … 160	90	Das Signal-Rausch-Verhältnis, das die Kette erreichen muss. Der Status schlägt unter 60 dB fehl.

Ausgaben

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

Ausgaben von audio-snr
Feld	Einheit	Beschreibung
snrHauptwert	dB	SNR
dynamicRange	dB	Dynamischer Bereich
snrLinear	:1	SNR (lineares Spannungsverhältnis)
noiseBits	bits	Effektive Noise-Bits

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": "audio-snr",
    "inputs": {
      "signalLevel": 0,
      "noiseFloor": -90,
      "targetSnr": 90
    }
  }'

import rftools

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

result = client.calculate("audio-snr", {"signalLevel": 0, "noiseFloor": -90, "targetSnr": 90})
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": "audio-snr",
    "inputs": {
      "signalLevel": 0,
      "noiseFloor": -90,
      "targetSnr": 90
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "audio-snr",
	  "inputs": {
	    "signalLevel": 0,
	    "noiseFloor": -90,
	    "targetSnr": 90
	  }
	}`)
	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": "audio-snr",
  "values": {
    "snr": 90,
    "dynamicRange": 90,
    "snrLinear": 31622.776601683792,
    "noiseBits": 14.94867642699313
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:audio-snr",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "signalLevel": {
          "min": -80,
          "max": 30,
          "unit": "dBV"
        },
        "noiseFloor": {
          "min": -140,
          "max": 0,
          "unit": "dBV"
        },
        "targetSnr": {
          "min": 0,
          "max": 160,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "signalLevel": 0,
      "noiseFloor": -90,
      "targetSnr": 90
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "signalLevel"
      ],
      "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 RechnerseiteAudio-SNR und Dynamikbereich, mit diesen Werten