ForHosting KIT · 音声・文字起こし

音声チャンネル配置を変換：モノラル、ステレオ、5.1の規則

音声チャンネルの名称は単純に見えますが、その背後には重要なルーティング判断があります。この機能は変換元と変換先の配置を受け取り、モノラル、ステレオ、5.1の間で適用する決定論的な割り当てを正確に返します。結果には全チャンネル、恒等変換・ダウンミックス・アップミックスの操作区分、および各出力の読みやすい式が含まれます。音声ファイルをアップロードしたりデコードしたりせずに、処理設計、トランスコードの文書化、設定検証、音の違いの説明にご利用いただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

音声を変更する前に割り当てをご確認ください

チャンネル配置の変換は、コンテナ内のラベルを書き換えるだけではありません。各出力スピーカーに明確な信号が必要であり、不適切なルーティングは台詞の消失、環境音の重複、予期しないレベル上昇を招きます。source_layoutとtarget_layoutにはmono、stereo、5.1のいずれかをご指定ください。応答は標準チャンネルを順番に示し、出力ごとに式を提示します。モノラルはM、ステレオはLとR、5.1はFL、FR、FC、LFE、SL、SRを使用します。0.5*L + 0.5*Rという式は、左右の入力が同じ割合でモノラル出力へ加わることを意味します。返されるのは処理済み音声ではなく仕様です。ファイルの受信やサンプル変更は行いません。そのため、設定の事前表示、技術資料、テスト期待値、別のエンコーダーで実行する前に変換内容を説明する画面に適しています。大文字と小文字、および前後の空白は区別しませんが、未知の配置を推測せずエラーとして扱います。

係数とヘッドルームをご理解ください

ダウンミックスは、多数の入力チャンネルを少数の出力へまとめます。ステレオからモノラルへは、左右を最大レベルのまま加算せず、左の0.5と右の0.5を組み合わせて適切な平均を保ちます。5.1からステレオへは、前方左右をそれぞれの側に維持します。センターは約マイナス三デシベルに相当する0.707で両側へ加わり、各サラウンドも0.707で対応する側へ加わります。LFEは番組全体の低音コピーではなく効果用チャンネルであり、自動的に足すと低域エネルギーが過大になる可能性があるため除外します。5.1からモノラルへの規則はステレオ規則を均等に畳み、前方左右を各0.5、センターを0.707、サラウンドを各0.3535とします。相関のある信号はフルスケールを超える場合があります。そのため、実際のレンダリングではゲイン低減やリミッターが必要になる旨も返します。式はルーティング比率を示すものであり、クリッピング防止、ラウドネス正規化、あらゆる放送仕様への適合を保証するものではありません。

アップミックスはルーティングとしてお考えください

アップミックスによって、収録されていない空間情報を復元することはできません。そのため、モノラルからステレオへはMをLとRへ複製します。モノラルから5.1へはMを前方センターに置き、ほかを無音にして、存在しないサラウンド音や効果音を作らず中央定位を保ちます。ステレオから5.1へはLとRを前方に維持し、半分ずつの組み合わせからセンターを作り、左右を対応するサラウンドへ複製し、LFEは無音にします。これは明示的で再現可能なルーティング計画であり、心理音響的なサラウンドデコーダーではありません。制作工程では、無相関化、遅延、フィルタリング、低音管理、特定のマトリックス方式などを追加できますが、それらは結果の範囲外です。変換元と変換先が同じ場合は恒等操作として報告し、全チャンネルを変更せず通過させます。これにより、リミックスがない場合も共通処理経路を監査できます。モノラル、ステレオ、5.1以外を含む組み合わせは入力エラーとなり、7.1などを別の配置として黙って扱うことはありません。

活用例

トランスコード設定を文書化

各出力チャンネルの生成方法を確認できるよう、エンコーダー設定と一緒に式を保存します。

メディア処理を事前確認

音声処理で出力する前に、予定するモノラル、ステレオ、5.1変換をご説明いただけます。

ルーティング想定を検証

安定した割り当てと設定を比較し、台詞の欠落、重複、未対応配置を早期に検出します。

よくある質問

音声ファイルそのものを変換しますか？

いいえ。音声処理に適用できる割り当てと式を返しますが、メディアのデコード、送信、レンダリングは行いません。

どの配置に対応していますか？

変換元と変換先の双方でモノラル、ステレオ、5.1に対応し、同一配置への恒等変換も含みます。

ダウンミックス時のLFEはどうなりますか？

LFEは除外します。効果用チャンネルを自動的に加えると、低域エネルギーが過大になる場合があるためです。

ダウンミックスでクリッピングしますか？

可能性があります。相関信号はフルスケールを超え得るため、ヘッドルーム、ゲイン低減、制限処理が必要な場合があります。

料金はいくらですか？

APIリクエスト1件につき$0.002です。決定論的な計算であり、ネットワーク接続やメディア送信は不要です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/audio/channel-layout-convert

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

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

curl -X POST https://api.kit.forhosting.com/audio/channel-layout-convert \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_layout":"5.1","target_layout":"stereo"}'

const res = await fetch("https://api.kit.forhosting.com/audio/channel-layout-convert", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "source_layout": "5.1",
    "target_layout": "stereo"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/audio/channel-layout-convert",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "source_layout": "5.1",
    "target_layout": "stereo"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/channel-layout-convert", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"source_layout":"5.1","target_layout":"stereo"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"source_layout":"5.1","target_layout":"stereo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/channel-layout-convert", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "source_layout": "5.1",
  "target_layout": "stereo"
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

`max_mb`	200
`max_minutes`	180

エラー

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

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