AgentBodyAgentBody
登录

YouTube Shorts 转 MP3 API

一次带鉴权的 POST 把任意 YouTube Shorts URL 转成已保存的 MP3——音频文件链接加规范化曲目元数据，干净 JSON 返回。

  • 单一 REST 端点
  • 所有 Shorts URL 形态
  • 格式控制
  • 规范化曲目元数据
  • 幂等的计费写入
  • 可预期的错误码
工具APIAgent

请求示例

查看 API 文档 完整 API 文档 
curl -X POST "https://api.agentbody.io/v1/youtube/music/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"audio_format":"mp3","region":"YOUR_REGION","url":"YOUR_URL"}'

响应示例

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

Retained audio file and normalized public track metadata.

{
  "audio_format": "mp3",
  "audio_url": "https://example.com/audio.mp3",
  "bitrate": 192000,
  "bytes": 4194304,
  "channel_title": "Example Channel",
  "content_type": "audio/mpeg",
  "duration_seconds": 180,
  "size_mb": 4,
  "title": "Example Track",
  "url": "https://www.youtube.com/watch?v=Gef1KePPRoI",
  "video_id": "Gef1KePPRoI"
}

功能特点

用 Shorts 转 MP3 API 搭建声音收集管线、播客工具和内容工作流——Shorts URL 进，音频链接出。

单一 REST 端点

带 bearer API 密钥和 Shorts URL 调用 POST /v1/youtube/music/download。API 保存音频并返回保留文件链接——无需流录制、无需维护浏览器自动化。

所有 Shorts URL 形态

youtube.com/shorts/ 链接、youtu.be 链接、App 分享链全部经同一请求解析。集成侧用户粘什么都能处理，省一步归一化。

格式控制

每次请求传 audio_format 为 mp3、m4a 或 webm，可用性因地区而异时可选地区码。响应报告实际交付的格式、码率和大小。

规范化曲目元数据

每个响应把 audio_url 与 video_id、title、频道、时长、码率、文件大小配对——管线可直接存储的稳定字段。

幂等的计费写入

音频保存是按量计费操作。重试时带 Idempotency-Key 头，中断的响应不会重复计费同一 Short——同键相同请求返回原始结果。

可预期的错误码

文档化状态码：400 请求无效、401 密钥缺失或错误、409 幂等冲突、502/503/504 暂时性上游问题——每类对应明确的修复或重试动作。

使用步骤

按以下步骤调用 Shorts 转 MP3 API：创建密钥，构造 POST 请求，处理返回的音频链接。

01

创建 API 密钥

创建 AgentBody 账号并在控制台生成 API 密钥。密钥留在服务端并以 bearer 令牌发送——绝不进浏览器代码。

02

构造请求

向 /v1/youtube/music/download 发送 POST，带必填的 Shorts url 和可选的 audio_format（mp3/m4a/webm）。生成示例展示五种语言的确切请求。

03

加幂等键

给每个可能重试的转换附 Idempotency-Key 头。同键相同请求返回原始响应，不重复计费。

04

密钥留在服务端

从后端、serverless 函数或定时任务调用端点。若终端用户触发转换，经你自己的端点代理。

05

解析 JSON 响应

读取返回的 audio_url、标题、频道、时长、码率和大小。把链接和元数据一起存储，或把 URL 直接交给存储层。

06

正确处理错误

400 修请求体，401 配好密钥，409 按文档化幂等键行为处理。502/503/504 同键带退避重试。

常见问题

YouTube Shorts 转 MP3 API 是什么？

一个带鉴权的 POST 端点 /v1/youtube/music/download，把公开 Short 的音频保存为 MP3、M4A 或 WebM，返回保留音频文件链接和规范化元数据——标题、频道、时长、码率、大小——以结构化 JSON 交付。

API 直接接受 Shorts URL 吗？

接受——youtube.com/shorts/VIDEO_ID 链接原生解析，youtu.be 链接和 App 分享链同样。一个请求结构覆盖所有 Shorts URL 格式。

价格怎么算？

每次音频保存是消耗账号额度的按量计费操作。价格由网关管理而非本页写死——控制台查单价，用幂等键确保重试不双重计费。

能提取哪些格式？

audio_format 字段支持 mp3（默认）、m4a、webm。响应确认交付的格式、码率和文件大小。

能提取私密 Shorts 的音频吗？

不能。端点只读取公开 Shorts——私密、会员专属和已删除内容不会解析，也不索要 YouTube 凭据。

怎么处理 API 错误？

400 修请求体，401 修 bearer 密钥，409 按文档化幂等键行为处理。把 502、503、504 当暂时性上游故障，同键带退避重试。