ForHosting KIT · 暮らし・料理・趣味

セントからピッチベンド値

Q: ピッチベンドの中心値は何ですか？

8192です。 音高変化なしを意味する14ビットの中立位置です。下限は0、上限は16383です。

ベンド幅2半音のシンセで100セント上げるには、ピッチベンド値12288が必要で、中央の8192より4096高い値です。セントとベンド幅を入れれば、正確なデチューンを自動化できます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

セント: 100
ベンドレンジ: 2

結果

範囲 (セント): 200
半音: 1
分数: 0.5
生の割合: 0.5

セントからピッチベンド値への計算機は、セントで測った音高オフセットを、シンセサイザーやDAWのオートメーションレーン、ハードウェアコントローラが期待する正確な14ビットMIDIピッチベンド整数へ変換します。希望のセント偏差と、中心から両端までの半音単位の楽器ベンド幅を入力すると、中心付き14ビット値（静止時8192）、範囲の符号付き比率、MIDIピッチベンドメッセージ用のMSBとLSB、要求が設定範囲を超えたときのclampフラグ、手計算で追える順序付きステップが返ります。

セントが14ビットMIDIピッチベンドに写像される仕組み

MIDIピッチベンドは各チャンネルボイスに付随する14ビット制御です。整数は0から16383までで、中立中心は8192であり、発音中のノートに対するデチューンなしを意味します。下端まで振り切ると0、上端まで振り切ると16383になります。

楽器は中心から各端までの半音でベンド幅を示し、2半音が一般的な既定、12が1オクターブ、一部のモノフォニックシンセはさらに広く開きます。音楽家やサウンドデザイナーはセントで考えることが多く、平均律の半音はちょうど100セント、オクターブは1200セントです。変換はセント領域で線形です。

希望セントをセント表示の幅（半音×100）で割り、得られた比率を−1から+1の閉区間にクランプし、14ビット尺度上に8192＋比率×8192として置き、最寄り整数へ丸め、合法なMIDI範囲へクランプします。正のセントは音高を上げ、負は下げ、0セントは正確な中心を返します。

実務のコツ、上限、関連検索

片側が2半音、もう片側が12のとき「想定の半分しか曲がらない」不具合の最頻因が誤った幅です。よく使うスタジオ基準は覚えやすく、2半音幅で100セントは全行程の半分で12288、同じ幅で−50セントは6144、0セントは常に8192です。

クライアントを制御できる場合は事前整形文字列より数値送信を優先し、数値文字列は厳密な有限数値パターンに一致する場合のみ受理されます。

このランディングはセントからピッチベンド計算機、セント由来のMIDIピッチベンド、14ビットベンド値変換を探す利用者向けで、周波数からセントへの変換、音声ファイルのピッチ検出、MIDIファイル書き出し、リアルタイムMIDIストリームではありません。

セントオフセットと楽器幅が既知でコントロール整数だけが必要なときは本能力を使い、2つの周波数から始めるなら専用の音程ツールで先にセントへ変換してください。

活用例

ハードウェアコントローラとMIDI鍵盤を校正する

ライブ技術者がセントで表したホイール行程を14ビット値へ変換し、ステージ上でハードウェアのベンド幅をソフト音源と一致させます。

よくある質問

ピッチベンドの中心値は何ですか？

8192です。音高変化なしを意味する14ビットの中立位置です。下限は0、上限は16383です。

centsがベンド幅を超えるとどうなりますか？

値は対応する端（丸め後0または16383）にクランプされ、応答はclampedをtrueにして超過を検出できるようにします。

ベンド幅2半音で100セント上げる値はいくつですか？

12288です。100セントは1半音で幅の半分にあたるため、中央の8192から最大の16383に向かって4096だけ上がります。

音程を上げずに下げるにはどうしますか？

セントを負の数で入れます。値は中央の8192より下がって0に近づき、ベンド幅2半音で100セント下げると4096になります。

ベンド幅を広げると同じセントでも変化が小さくなるのはなぜですか？

セントを幅全体で割って計算するからです。幅が12半音なら100セントは道のりのごく一部で、値は中央からあまり離れません。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/hobby/music-cents-to-pitch-bend

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/hobby/music-cents-to-pitch-bend \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cents":100,"bend_range":2}'

const res = await fetch("https://api.kit.forhosting.com/hobby/music-cents-to-pitch-bend", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cents": 100,
    "bend_range": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/hobby/music-cents-to-pitch-bend",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "cents": 100,
    "bend_range": 2
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/music-cents-to-pitch-bend", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"cents":100,"bend_range":2}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"cents":100,"bend_range":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/music-cents-to-pitch-bend", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "cents": 100,
  "bend_range": 2
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "hobby.music_cents_to_pitch_bend",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

非正のベンド幅や非有限入力はinvalid_inputで拒否され、自動化が不正なコントロール値を保存しません。経路は純粋な算術で、ネットワークも乱数シードも壁時計依存もなく、無料のブラウザ実行と前払いAPIは、公開価格$0.002の成功リクエストごとに、固定小数点丸め後に同じJSONを返します。

セントが14ビットMIDIピッチベンドに写像される仕組み

要求セントが設定幅を超えると値は端に固定され、booleanのclampedフラグが立ち、クライアントは利用者へ警告したりオートメーションを再スケールしたりできます。この線形モデルは大半のシンセがピッチベンドメッセージを解釈する方法と一致し、心理音響曲線ではなく、純正音程の周波数比計算を置き換えるものでもありません。

APIの呼び出し方と返却内容

ベンド幅は0より大きく最大96半音、centsの絶対値は100万以内です。steps配列は生のcentsからセント幅、比率、14ビット配置、整数clamp、MSB/LSB分割まで進み、テストで中間値を検証できます。必須の有限数2つをJSON本体で送ってください。cents（別名 deviation_cents、pitch_cents、cents_offset、detune_cents）と bend_range（別名 range、range_semitones、bend_range_semitones、semitone_range、pb_range）です。欠落、非数値文字列、非有限値、範囲外はinvalid_inputで、課金されません。成功時は丸めたcentsとbend_rangeを返し、range_centsにbend_range×100、semitonesにcents÷100、fractionにクランプ後の比率、raw_fractionに未クランプ比、clampedにboolean、pitch_bendとpitch_bend_14bitに0から16383の同一整数、offset_from_centerにpitch_bend−8192、msbとlsbに7ビットMIDIデータバイト、center・min・maxにプロトコル定数、unitに文字列midi_pitch_bend、formulaにclampと丸めの閉じた関係、messageに短い英語要約を入れます。料金は成功リクエストあたり定額$0.002（単位item）です。

実務のコツ、上限、関連検索

bend_rangeは楽器やDAWが実際に使う値に合わせてください。指導では正の成功経路と、意図的な0または負のベンド幅を組み合わせて厳格なinvalid_input経路を示し、超過ケースを加えてclampedがtrueになる様子を見せてください。invalid_inputの失敗タスクは前払い残高を消費せず、学習者が端を意図的に試す探索スクリプトを安く保てます。往復確認は、8192＋cents÷range_cents×8192を再計算し、丸めて0…16383にクランプし、pitch_bendと一致することを確認すれば十分です。

連携の活用例

シンセのピッチベンドオートメーションを組む

サウンドデザイナーが目標デチューン（セント）とパッチのベンド幅を入力し、正確なランプのためpitch_bendをDAWオートメーションやSysExスクリプトに貼ります。

MIDIライブラリと仮想楽器の単体テスト

開発者が既知のcentsとbend_rangeフィクスチャを、音声ハードウェアなしで決定的なpitch_bend・MSB・LSB出力と照合します。

技術的な質問

セントをMIDIピッチベンド値へどう変換しますか？

centsを(bend_range × 100)で割って設定幅の比率を求め、その比率を[−1, +1]にクランプし、pitch_bend = round(8192 + fraction × 8192)を計算して0…16383にクランプします。

bend_rangeが0または負の場合は？

ツールはinvalid_inputを返します。非正のベンド幅ではセントから制御への有意味な写像を定義できません。

セントからピッチベンド値計算機は無料ですか？

ブラウザツールは無料でローカル実行です。API呼び出しは成功リクエストあたり$0.002のKIT前払い残高を使い、失敗タスクは課金されません。

KITの完全なドキュメントを見る →

セントからピッチベンド値

無料で実行

計算例

セントが14ビットMIDIピッチベンドに写像される仕組み

実務のコツ、上限、関連検索

活用例

ハードウェアコントローラとMIDI鍵盤を校正する

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

セントが14ビットMIDIピッチベンドに写像される仕組み

APIの呼び出し方と返却内容

実務のコツ、上限、関連検索

連携の活用例

シンセのピッチベンドオートメーションを組む

MIDIライブラリと仮想楽器の単体テスト

技術的な質問

ありがとう