まずは許可された動画を1本から始めましょう
YouTubeからMP3へ ビデオリンクは1つ受け付けています。サインインし、リンクを貼り付け、MP3、AAC、WAVを選択し、圧縮音声のビットレートを選択して変換を開始します。ファイルがダウンロードが終わるまで、ページを開いて前景に置いたままにしてください。
所有または許可を得た動画を使用し、ダウンロード・処理を行い、YouTubeの利用規約および適用法を遵守してください。このワークフローはプライベートビデオアクセスやペイウォール、DRMを回避する方法ではありません。
URLバリデーターは、認識されたYouTube視聴、ショートリンク、ショート、埋め込みフォームを受け付け、有効な11文字の動画IDをウォッチURLに正規化します。認識されていないホストや異常なIDは拒否されます。プレイリストやアクティブなライブストリームはサポートされていません。有効なURLがあっても、動画がアクセス可能であることは保証されません。
最終エンコーディングからの抽出分離
ダウンロードタスクでは、動画フレームを取得するのではなく、利用可能な最良の音声専用ストリームを選択するためにyt-dlpを使用します。ソースはWebMやM4Aのようなコンテナで到着することもあります。その拡張はすでにMP3であることを約束するものではありません。
バックエンドはそのソースオーディオを準備し、エクスポートステップに公開します。FFmpegソースを復号し、選択した宛先フォーマットをエンコードします。したがって、サーバーのソースレディ状態は、MP3ダウンロードが完了した状態とは異なります。
ソースの準備、転送、符号化、保存は別々の段階です。進捗バーはこれらの段階を組み合わせており、正確な経過時間予報として読むべきではありません。これらの説明は測定された速度ベンチマークではなく、実装に基づいています。
Video URL
-> validated single-video task
-> yt-dlp audio-only source
-> source transfer
-> FFmpeg audio encoding
-> downloadable MP3, AAC or WAV実際の出力エンコーディングを選択します
| 音声フォーマット | エンコーダーとコンテナ | 実用的な区別 |
|---|---|---|
| MP3 | libmp3lameエンコーダー;MP3コンテナ | ロス圧縮音声と幅広いプレイヤーサポート;選択可能な128、192、または320 kbps |
| AAC | AACエンコーダー;.aac拡張子を持つADTSコンテナ | ロッシー圧縮オーディオ;この出力はM4Aファイルではありません |
| WAV | pcm_s16leエンコーダー;WAVコンテナ | 非圧縮16ビットPCM;圧縮オーディオビットレートセレクターは隠されています |
エクスポートコマンドは映像出力を削除し、音声エンコーダとコンテナを明示的に選択します。サンプルレートやチャンネル数を明示的に強制するわけではないので、すべての結果が44.1 kHzのステレオであることを約束するものではありません。重要な場合は完了ファイルを確認してください。
ffmpeg -i input.webm -vn -codec:a libmp3lame -b:a 192k -f mp3 output.mp3
ffmpeg -i input.webm -vn -codec:a aac -b:a 192k -f adts output.aac
ffmpeg -i input.webm -vn -codec:a pcm_s16le -f wav output.wavこれらのコマンドは、入力名の例を添えて設定したエクスポート引数を示しています。それらは別のコマンドラインダウンロードサービスではありません。すでに持っている音声ファイルについては、 オーディオコンバーター;ビデオファイルからサウンドトラックを抽出するには、 ビデオから音声へ.
ビットレートはサイズを変えるのであって、ソース録画自体ではありません
320 kbpsを選んでも、すでにソースに欠けている詳細は復元されません。MP3またはAACとして再エンコードされたロッシーソースは、さらに別のロッシーエンコーディングステップを経ます。WAVはその追加のロッシーコーデックを回避しますが、元のスタジオ録音を再構築することはできません。
圧縮音声の場合、おおよそのペイロードサイズはビットレートに持続時間を掛け、さらに8で割ったものです。192 kbpsでの10分間のパスは、コンテナのオーバーヘッド前で約14.4MBの容量になります(10進メガバイト)。これはサイズの推定であり、品質やタイミングの測定ではありません。
Compressed payload bytes ~= bitrate_bits_per_second * duration_seconds / 8
192000 * 600 / 8 = 14400000 bytes = 14.4 MB
16-bit PCM payload bytes ~= sample_rate * channels * 2 * duration_seconds
48000 * 2 * 2 * 600 = 115200000 bytes = 115.2 MBWAVの例では計算の説明のために48 kHzのステレオを仮定しています。それは出力の保証ではありません。コンテナヘッダーや実際のエンコーディング動作はファイルサイズを変えることがあります。大きめのファイルがより良く聞こえるからではなく、目的地のプレーヤーや編集ワークフローに合ったフォーマットを選ぶべきです。
タスクステート、アクセスおよび期限
タスク作成には認証済みアカウントが必要です。ステータス、ハートビート、ソース取得、完了、キャンセルエンドポイントはタスク所有権の確認、タスクIDだけでは他人の結果をダウンロードする許可ではありません。
POST /api/jobs create an authenticated task (202)
POST /api/jobs/{id}/heartbeat keep the task active and read status
GET /api/jobs/{id}/source retrieve source audio when ready
POST /api/jobs/{id}/complete report successful export
POST /api/jobs/{id}/cancel cancel the taskソースタスクはキューに入れ、ダウンロード、回復、アップロード、完了またはエラーを扱うことができます。段階によっては展開設定によって異なります。オプションのオブジェクトストレージは、選択した出力コーデックではなく、送信元の配信を変更します。送信元エンドポイントはソースファイルルートか期限切れのストレージURLのいずれかを返します。
設定されたソース-結果のライフタイムは、バックエンドタスク終了後1時間です。速やかにダウンロードしてください;長い輸出が終わる前に期限切れになることがあります。ソースの有効期限と、最終ファイルが正常に保存されたのは別物です。セッション復元は、以前のメモリ内エクスポートやダウンロードリンクがリフレッシュしても必ず存続する保証はありません。
限界と一般的な故障
ダウンロード機能は最大7,200秒の動画と最大250Mのソースダウンロードサイズに対応しています。これらはソースタスクの制限であり、すべての2時間動画が成功するとか、最終的なWAVがそのサイズに合うという約束ではありません。ダウンロード試行には1,800秒のタイムアウトがあります。
キューが満杯だったり、サーバーリソースが不足すると、タスクが遅延したり拒否されたりすることがあります。動画の削除、制限、利用不可、プラットフォーム認証、ネットワーク障害、ソースの期限切れ、エンコードエラーなども完了を妨げる可能性があります。有効なURLと進行バーが見えるからといって、パイプライン全体が成功したとは限りません。
ソース準備後にエンコードが失敗した場合、インターフェースはオリジナルの音声ダウンロードを提供できます。そのファイルはソースフォーマットを保持し、フォールバックMP3ではありません。使用前に拡張機能とプレイヤー対応を確認してください。許可された短い動画を試し、ページを前景に置き、報告されたエラーを確認してから再挑戦してください。