YouTube 转 WAV API

通过一次 POST 将公开 YouTube 视频转换为 WAV。响应返回永久音频下载 URL 和标准化曲目元数据。

一次 POST，一个 WAV 文件
永久下载 URL
PCM 解码，无二次有损
单一端点八种格式
幂等键支持
需要服务器端密钥

请求示例

curl -X POST "https://api.agentbody.io/v1/youtube/audio/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"bitrate":"source","format":"mp3","url":"YOUR_URL"}'

响应示例

来自 OpenAPI 规范的已文档化响应。

Retained audio file URL and normalized public track metadata.

{
  "audio_url": "https://example.com/audio-dQw4w9WgXcQ.mp3",
  "bitrate": "192k",
  "channel": "Example Channel",
  "duration_seconds": 212,
  "file_size_bytes": 3407872,
  "format": "mp3",
  "thumbnail_url": "https://example.com/thumbnail-dQw4w9WgXcQ",
  "title": "Example Track",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "video_id": "dQw4w9WgXcQ"
}

功能特点

youtube.audio_download 操作配合 format=wav 将一个公开 YouTube 视频转换为保存的 WAV 文件。您的服务器持有 API 密钥；端点在单次调用中返回永久下载 URL。

一次 POST，一个 WAV 文件

发送 POST /v1/youtube/audio/download 和视频 URL 及 format: "wav"。成功的 200 返回 video_id、title、channel、duration、audio_url、format 和 file_size_bytes——音频管道所需的一切。

永久下载 URL

audio_url 指向完全保存的文件，而非过期 CDN 跳转。可从任何服务器、任何 IP、任何时间下载——适合队列工作器、媒体服务器和长期引用。

PCM 解码，无二次有损

WAV 输出一次性解码为无压缩 PCM 且不再压缩。源流仍限制质量上限，但出口无损失——正是编辑和采样工作流需要的。

单一端点八种格式

format 参数接受 wav、mp3、m4a、aac、flac、opus、vorbis 和 alac。一次集成覆盖产品所需的全部音频输出——每次调用改 format 值即可。

幂等键支持

传递 Idempotency-Key 头，重试不会触发第二次转换或扣费。网关按键去重——网络不稳定也安全。

需要服务器端密钥

端点需要服务器持有的 AgentBody API 密钥。通过后端路由调用；绝不将密钥发到客户端。

使用步骤

三步 API 集成 YouTube 转 WAV。

获取 API 密钥

创建免费 AgentBody 账户并从仪表板生成 API 密钥。

POST 并指定 format=wav

向 /v1/youtube/audio/download 发送 POST 请求和公开视频 URL 及 "format": "wav"。包含 Idempotency-Key 头以安全重试。

接收下载链接

200 返回永久 WAV URL 及标题、频道、时长和文件大小。直接下载或交给存储管道。

常见问题

YouTube 转 WAV API 如何工作？

向 /v1/youtube/audio/download 发送 POST 请求和公开视频 URL 及 "format": "wav"。API 转换音频，保存 WAV 文件，并返回带标准化元数据的永久下载 URL。

响应包含什么？

video_id、url、title、channel、duration_seconds、audio_url（永久 WAV 下载链接）、thumbnail_url、format（"wav"）、bitrate 和 file_size_bytes。

WAV 输出是无损的吗？

WAV 输出是无压缩 PCM，无第二次有损压缩。质量上限仍是 YouTube 提供的源流——API 从不声称恢复从未存在的细节。

端点还支持哪些格式？

mp3、m4a、wav、aac、flac、opus、vorbis 和 alac——全部通过同一端点的 format 参数。一次集成覆盖所有需要的输出。

如何计费？

每次成功转换按网关管理价格从您的 AgentBody 余额扣除固定金额。失败不计费；Idempotency-Key 头防止重试重复扣费。

有时长限制吗？

超过约 25 分钟的视频被上游成本保护拒绝，以保持每次转换价格可预测。长内容请分段或用 API 分开调用。