ドキュメントのセクション

I2S オーディオインターフェースタイミング計算ツール

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

スラッグ i2s-timing。オーディオインターフェースのI2Sビットクロック (BCLK)、ワードクロック (LRCLK/WCLK)、データレートを任意のサンプルレート、ビット深度、チャンネル数で計算できます。

入力

これらの入力を、表示されている単位ですべて inputs に入れて送ってください。ほとんどは必須で、1 つでも欠けた呼び出しは拒否され（400）、費用はかかりません。省略しても計算できる入力は、表示されている既定値を使います。範囲外の入力も計算され、来歴で示されます。

i2s-timing の入力
名前	単位	範囲	既定値	説明
sampleRate数値	kHz	0.1 … 768	44.1	オーディオのサンプルレート (例：44.1、48、96、192 kHz)
bitDepth数値	bits	8 … 64	24	サンプルあたりのビット数 (一般的には 16、24、32 ビット)
channels数値	なし	1 … 32	2	オーディオのチャネル数 (モノラルは 1、ステレオは 2)
mclk数値	MHz	0.1 … 200	16.9344	BCLK を整数で分周する元のクロック：16.9344 MHz は 384 × 44.1 kHz、12.288 MHz は 256 × 48 kHz
rateBudget数値	%	0.001 … 10	0.1	リンクが許容できるサンプルレート誤差。±0.1 % (1000 ppm) は、民生用デジタルオーディオに対する IEC 60958-3 のレベル II のクロック精度です

出力

values に名前ごとに返されます。上限がない値や定義されない値は null です。

i2s-timing の出力
フィールド	単位	説明
bclk主要値	MHz	ビットクロック (BCLK)
wclk	kHz	ワードクロック (LRCLK)
bclkPeriod	ns	BCLK 周期
dataRate	Mbps	データレート
mclkDivider	なし	MCLK 分周比
bclkActual	MHz	実際の BCLK
sampleRateActual	kHz	実際のサンプルレート
sampleRateError_pct	%	サンプルレート誤差

呼び出し方

計算：1 回の呼び出し、リクエストとレスポンスの全体、そのエラー。
バッチ：この計算ツールをほかと組み合わせて、または掃引を、1 リクエストで。
目標値からの逆算：出力を目標値にする入力の値。

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "i2s-timing",
    "inputs": {
      "sampleRate": 44.1,
      "bitDepth": 24,
      "channels": 2,
      "mclk": 16.9344,
      "rateBudget": 0.1
    }
  }'

import rftools

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

result = client.calculate("i2s-timing", {
    "sampleRate": 44.1,
    "bitDepth": 24,
    "channels": 2,
    "mclk": 16.9344,
    "rateBudget": 0.1,
})
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": "i2s-timing",
    "inputs": {
      "sampleRate": 44.1,
      "bitDepth": 24,
      "channels": 2,
      "mclk": 16.9344,
      "rateBudget": 0.1
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "i2s-timing",
	  "inputs": {
	    "sampleRate": 44.1,
	    "bitDepth": 24,
	    "channels": 2,
	    "mclk": 16.9344,
	    "rateBudget": 0.1
	  }
	}`)
	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": "i2s-timing",
  "values": {
    "bclk": 2.1168,
    "wclk": 44.1,
    "bclkPeriod": 472.411186696901,
    "dataRate": 2.1168,
    "mclkDivider": 8,
    "bclkActual": 2.1168,
    "sampleRateActual": 44.1,
    "sampleRateError_pct": 0
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:i2s-timing",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Philips I2S Bus Specification, 1996",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "sampleRate": {
          "min": 0.1,
          "max": 768,
          "unit": "kHz"
        },
        "bitDepth": {
          "min": 8,
          "max": 64,
          "unit": "bits"
        },
        "channels": {
          "min": 1,
          "max": 32,
          "unit": ""
        },
        "mclk": {
          "min": 0.1,
          "max": 200,
          "unit": "MHz"
        },
        "rateBudget": {
          "min": 0.001,
          "max": 10,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "sampleRate": 44.1,
      "bitDepth": 24,
      "channels": 2,
      "mclk": 16.9344,
      "rateBudget": 0.1
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

テキストとして送られた入力。計上はされていません。

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

1 分あたりのリクエストが多すぎます。Retry-After 付き。

同じ入力で計算ツールのページを開くI2S オーディオインターフェースタイミング計算ツール、この値で