AgentBodyAgentBody
登录

Instagram 音频下载器 API

通过一次 POST 从公开 Instagram Reel 或视频提取音频。响应返回永久 MP3 下载 URL 和标准化曲目元数据。

  • 一次 POST，一个音频文件
  • 永久下载 URL
  • 支持所有公开帖子类型
  • 标准化曲目元数据
  • 幂等键支持
  • 需要服务器端密钥
工具APIAgent

请求示例

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

响应示例

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

Retained Instagram audio file URL and normalized public track metadata.

{
  "artist": "Example Artist",
  "audio_type": "licensed",
  "audio_url": "https://api.apify.com/v2/key-value-stores/example/records/audio_DcSAqhCTTrX.m4a",
  "cover_url": "https://example.com/cover.jpg",
  "duration_ms": 175453,
  "file_size_bytes": 1833377,
  "is_trending": true,
  "post_url": "https://www.instagram.com/reel/DcSAqhCTTrX/",
  "shortcode": "DcSAqhCTTrX",
  "title": "Example Track"
}

功能特点

instagram.audio_download 操作从一个公开 Instagram 帖子提取音轨。您的服务器持有 API 密钥；端点在单次调用中返回永久下载 URL 和标准化元数据。

一次 POST，一个音频文件

发送 POST /v1/instagram/audio/download 和公开 Instagram URL。成功的 200 返回 shortcode、post_url、audio_url、title、artist、duration_ms、file_size_bytes、cover_url、audio_type 和 is_trending——下载器管道所需的一切在一个响应中。

永久下载 URL

audio_url 指向完全保存的文件，而非过期的 CDN 跳转。它可从任何服务器、任何 IP、任何时间下载，因此您可以将其交给队列工作器、媒体服务器或直接交给最终用户，无需重新运行提取。

支持所有公开帖子类型

url 参数接受 Reels、标准视频帖子和 IGTV 链接。API 自动解析帖子的音轨；私密、已删除或受限帖子返回 400 或 502 错误而非文件。

标准化曲目元数据

每个响应包含曲目标题、艺术家姓名、时长（毫秒）、文件大小（字节）、封面图像 URL、音频分类（licensed、original 或 none）和 trending 标志——无论创作者如何上传，所有帖子均一致。

幂等键支持

传递 Idempotency-Key 头以安全重试失败请求而不产生重复费用。网关按键去重，因此网络重试永远不会为同一帖子触发第二次提取。

需要服务器端密钥

端点需要服务器持有的 AgentBody API 密钥。绝不在客户端代码中暴露密钥；通过后端路由所有调用以保持密钥安全并跟踪使用量。

使用步骤

通过 API 三个步骤集成 Instagram 音频提取。

01

获取 API 密钥

创建免费 AgentBody 账户并从仪表板生成 API 密钥。密钥验证每个请求并跟踪您的余额使用量。

02

POST 帖子 URL

向 /v1/instagram/audio/download 发送 POST 请求，请求体中包含公开 Instagram 帖子 URL。包含 Idempotency-Key 头以安全重试。

03

接收下载链接

成功的 200 响应返回永久 audio_url 和曲目元数据。直接从链接下载 MP3，或将其交给媒体管道进行存储和分发。

常见问题

Instagram 音频下载器 API 如何工作？

向 /v1/instagram/audio/download 发送 POST 请求和公开 Instagram 帖子 URL。API 提取音轨，保存为 MP3 文件，并返回永久下载 URL 以及标准化元数据，包括标题、艺术家、时长和文件大小。

支持哪些 Instagram URL 格式？

API 接受 Reels URL（instagram.com/reel/{shortcode}）、标准视频帖子 URL（instagram.com/p/{shortcode}）、IGTV URL（instagram.com/tv/{shortcode}）和分享链接。帖子必须公开可访问；私密或受限帖子返回错误。

响应格式是什么？

成功的 200 响应返回 JSON 对象：shortcode、post_url、audio_url（永久 MP3 下载链接）、title、artist、duration_ms、file_size_bytes、cover_url、audio_type（licensed/original/none）和 is_trending（布尔值）。

有速率限制或使用上限吗？

每次成功提取按网关管理的价格从您的 AgentBody 余额中扣除固定金额。除账户余额外无单独速率限制；失败请求（400、502 等）不计费。使用 Idempotency-Key 头防止重试产生重复费用。

可以从私密 Instagram 账户提取音频吗？

不可以。API 只能处理公开可用的帖子。私密账户、已删除帖子和年龄限制内容被 Instagram 平台拒绝，返回 400 或 502 错误。

使用此 API 下载 Instagram 音频合法吗？

仅将 API 用于您拥有、有权保存或有其他合法依据的公开可用内容。尊重版权法和 Instagram 服务条款。API 根本无法访问私密或受限内容。