从一条获准处理的视频开始
YouTube转MP3 支持单条视频链接。登录后粘贴链接,选择 MP3、AAC 或 WAV,为压缩音频选择码率并开始转换。保持页面打开并处于前台,直到文件下载完成。
请使用自己拥有或获准下载处理的视频,并遵守 YouTube 条款及适用法律。本流程不能用于绕过私人视频访问限制、付费墙或 DRM。
链接校验支持识别的 YouTube watch、短链接、Shorts 和嵌入链接,将有效的 11 字符视频 ID 规范化为 watch 地址。不接受未知主机或格式错误的 ID。不支持播放列表和正在进行的直播;链接有效不保证视频可以访问。
区分音轨提取与最终编码
下载任务使用 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 编码器,ADTS 容器,扩展名为 .aac | 有损压缩音频,这不是 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 避免了额外的有损编码,但不能重建原始录音室录音。
压缩音频的有效载荷体积约等于码率乘以时长,再除以八。按十进制 MB 计算,10 分钟、192 kbps 的片段约为 14.4 MB,未计容器开销。这是体积估算,不是音质或耗时测量。
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源音轨任务可能处于 queued、downloading、recovering、uploading、done 或 error 状态,部分阶段取决于部署配置。可选对象存储改变源音轨的传送方式,而不改变所选输出编码。源音轨接口会返回文件路由或带过期时间的存储地址。
源音轨结果配置为在后端任务完成一小时后过期。请及时下载,较长导出尚未完成时源音轨可能已经过期。源音轨过期与已经成功保存的最终文件是两回事。恢复会话不保证刷新前的内存导出结果或下载链接仍然有效。
限制与常见失败原因
下载器配置的视频时长上限为 7,200 秒,源音轨下载大小上限为 250M。这些是源音轨任务的限制,不保证每个两小时视频都能成功,也不保证最终 WAV 小于该体积。下载尝试还设有 1,800 秒超时。
队列已满或服务器资源不足时,任务可能等待或被拒绝。视频被删除、受限或不可访问,以及平台验证、网络失败、源音轨过期和编码错误,也会阻止完成。链接有效且显示进度,不代表整个流程已经成功。
若源音轨准备完成后编码失败,界面可提供原始音频下载。该文件保留源格式,并不是备用 MP3。使用前应检查扩展名和播放器支持。可尝试较短的获准处理视频,保持页面在前台,并先查看错误说明再重试。