ForHosting KIT · 音声・文字起こし

クロスフェード時間計算

クロスフェードでは、切り替え中に2つのクリップを同時再生するため、完成したシーケンスは単純な合計より短くなります。この計算ツールに最初のクリップの長さ、次のクリップの長さ、希望するクロスフェード時間を入力すると、完成後の合計時間と、共通タイムライン上の重複開始・終了位置が得られます。編集計画、納品尺の確認、マーカー配置、自動オーディオ処理に必要な再現可能な時間データの作成にご利用いただけます。

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

無料で実行 API仕様を見る

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

クロスフェードによる時間の変化を理解する

2つのクリップを隙間なく順番に並べるだけなら、シーケンスの長さは両方の時間を足した値になります。クロスフェードを設定すると、クリップAの終端とクリップBの冒頭がタイムライン上の同じ区間を使用するため、計算方法が変わります。この共有区間を二重に数えないよう、ツールは2つの長さの合計から指定されたクロスフェード時間を1回だけ差し引きます。クリップAはタイムラインの0から始まり、クリップBは冒頭がクリップAの終端と重なる位置まで前に移動するものとして扱います。この前提では、重複区間の終了位置は必ずクリップAの終了位置と一致します。0秒のクロスフェードも有効で、これは通常の直結カットを表します。その場合、重複窓の幅は0になり、合計時間は2つの長さの和と同じです。値はすべて秒で扱い、小数を使えばフレームレートを指定せずに1秒未満の精度も表現できます。

重複区間の開始と終了を正しく読む

出力される重複区間は、各ソースファイル内の位置ではなく、完成後の共通タイムライン上の位置です。開始位置はクリップAの長さからクロスフェード時間を引いた値で、終了位置はクリップAの全長と同じです。たとえば、最初のクリップが12秒、クロスフェードが2秒なら、重複は10秒で始まり12秒で終わります。クリップBは出力された開始位置から再生され、クリップAが終わった後も、重なっていない残りの部分が続きます。この時刻は単一のタイムラインを基準にしているため、編集マーカー、オートメーションの合図、検証ログへそのまま利用できます。本ツールは音声サンプルを解析せず、フェード曲線を選択せず、メディアも加工しません。計算対象は時間だけです。イコールパワー、直線、対数、独自の各カーブでも同じ重複区間を使えるため、カーブの選択は別のミキシング判断として行ってください。

レンダリング前に編集条件を検証する

クロスフェードは、参加するどちらのクリップよりも長く設定できません。重複全体を構成する素材が両方に必要なため、クリップAまたはクリップBの長さを超える指定はエラーになります。また、未入力、数値以外、無限値、負数、0のクリップ時間も受け付けません。クロスフェード自体は0にできますが、負数にはできません。この検証により、誤った時間指定がレンダラーまで進み、ほかの処理を終えた後で失敗する事態を防げます。合計時間はプレイリスト、番組、書き出し目標の確認に、区間の両端は遷移イベントの一貫した配置にお使いください。3つ以上のクリップをつなぐ場合は接続ごとに計算するか、全クリップの合計から有効な各クロスフェードを1回ずつ引きます。本機能が扱うのは2つのクリップのみで、無音区間、再生速度変更、トリミング、追加の同時レイヤーは考慮しません。

活用例

オーディオ編集を計画する

エディターでクロスフェードを作る前に、完成尺を計算して正確なマーカーを配置できます。

一括レンダリング条件を検証する

実行不可能な遷移時間を、オーディオ処理工程へ送る前に検出できます。

プレイリストの尺を見積もる

2つの楽曲、セグメント、環境音を並べる際に、重複で短くなる時間を反映できます。

よくある質問

合計時間はどのように計算しますか？

2つのクリップ時間を足し、共有されるクロスフェード時間を1回だけ差し引きます。

重複区間はどこから始まりますか？

最初のクリップの長さからクロスフェード時間を引いた位置で始まり、最初のクリップの終了時に終わります。

クロスフェード時間を0にできますか？

はい。0は直結カットを表し、幅0の重複窓となるため、2つの長さの合計は変わりません。

クロスフェードがクリップより長い場合はどうなりますか？

各クリップが重複全体をカバーする必要があるため、無効な入力としてエラーを返します。

APIリクエストの料金はいくらですか？

APIリクエスト1回につき$0.002です。同じ決定的な計算をブラウザーでも実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/audio/crossfade-duration

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

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

curl -X POST https://api.kit.forhosting.com/audio/crossfade-duration \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"clip_a_duration":12.5,"clip_b_duration":8.25,"crossfade_duration":2.75}'

const res = await fetch("https://api.kit.forhosting.com/audio/crossfade-duration", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "clip_a_duration": 12.5,
    "clip_b_duration": 8.25,
    "crossfade_duration": 2.75
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/audio/crossfade-duration",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "clip_a_duration": 12.5,
    "clip_b_duration": 8.25,
    "crossfade_duration": 2.75
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/crossfade-duration", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"clip_a_duration":12.5,"clip_b_duration":8.25,"crossfade_duration":2.75}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"clip_a_duration":12.5,"clip_b_duration":8.25,"crossfade_duration":2.75}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/crossfade-duration", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "clip_a_duration": 12.5,
  "clip_b_duration": 8.25,
  "crossfade_duration": 2.75
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "audio.crossfade_duration",
  "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の完全なドキュメントを見る →