Instagram 转 MP4 API

一次带鉴权 POST 把公开 Instagram 视频或 Reel URL 转成保留的 MP4 文件链接——附封面图、创作者和互动数据，干净 JSON。

单一 REST 端点
所有视频链接形态
文件带完整上下文
Reel 与 IGTV 全包含
幂等的计费写入
可预期的错误码

请求示例

curl -X POST "https://api.agentbody.io/v1/instagram/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url":"YOUR_URL"}'

响应示例

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

Retained Instagram media link and normalized public post metadata.

{
  "author_name": "Example Author",
  "author_username": "example",
  "comment_count": 310,
  "duration_seconds": 29.5,
  "like_count": 18420,
  "media_type": "video",
  "play_count": 512334,
  "post_url": "https://www.instagram.com/reel/DWocNOhgmgg/",
  "shortcode": "DWocNOhgmgg",
  "text": "Example caption",
  "thumbnail_url": "https://example.com/cover.jpg",
  "video_content_type": "video/mp4",
  "video_url": "https://api.apify.com/v2/key-value-stores/example/records/DWocNOhgmgg.mp4"
}

功能特点

用 Instagram 转 MP4 API 驱动下载器、搬运管线和内容工具——视频 URL 进，带完整帖子上下文的保留 MP4 链接出。

单一 REST 端点

带 bearer API 密钥和视频 URL 调用 POST /v1/instagram/video/download。API 保存 MP4 并返回保留文件链接——无需浏览器自动化、无需爬虫栈、无需维护非官方客户端 SDK。

所有视频链接形态

Reel 链接、/p/ 帖子链接、/tv/ 链接、App 分享链全部经同一请求解析。集成侧用户粘什么都能处理，省一步归一化。

文件带完整上下文

每个响应把 video_url 与 thumbnail_url、shortcode、文案、作者名和用户名、时长、播放/点赞/评论数配对——下载器和存档的完整记录。

Reel 与 IGTV 全包含

Instagram Reel、标准视频帖、较长的 IGTV 式片段解析方式一致。一次集成覆盖用户粘贴的每一类 Instagram 视频。

幂等的计费写入

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

可预期的错误码

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

使用步骤

按以下六步调用 Instagram 转 MP4 API：创建密钥，传入视频 URL，处理返回的 MP4 链接。

创建 API 密钥

创建 AgentBody 账号并在控制台生成 API 密钥。密钥放在服务端环境或受认可的密钥库，以 bearer 令牌发送。绝不把生产密钥放进浏览器代码。

选定公开视频

选要转换的公开 Instagram 视频或 Reel，复制其 URL。私密账号链接和已删除帖子不会解析——需要覆盖时备好替代。

构造请求

向 /v1/instagram/video/download 发送 POST，带必填的 url 和 Idempotency-Key 头。生成示例展示五种语言的确切请求。

密钥留在服务端

从后端、serverless 函数或定时任务调用端点——密钥不出浏览器的地方。若向终端用户开放转换，经你自己的端点代理。

处理输出

读取返回的 video_url、thumbnail_url、文案、创作者和互动字段。把 MP4 链接和元数据一起存储——schema 跨请求稳定。

正确处理错误

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

常见问题

Instagram 转 MP4 API 是什么？

一个带鉴权的 POST 端点 /v1/instagram/video/download，把公开 Instagram 视频或 Reel 保存为保留的 MP4 文件链接，返回时附封面图 URL、文案、创作者、时长和播放/点赞/评论数，以干净 JSON 交付。

有免费的 Instagram 转 MP4 API 吗？

可以从免费 AgentBody 账号开始，每次调用消耗账号额度——先免费试用再决定量。用量计价由网关管理，而非本页写死的数字。

能把 Instagram Reel 转成 MP4 吗？

能——Reel 与标准视频帖走同一请求解析。提交 Reel 的 URL，响应返回 MP4 链接和 Reel 的封面图、互动数据；一次集成两者通吃。

响应包含什么？

video_url（保留的 MP4 链接）、thumbnail_url、shortcode、post_url、text（文案）、author_name、author_username、media_type、duration_seconds 和 play_count/like_count/comment_count。

IGTV 链接支持吗？

支持——/tv/ 链接与 Reel、标准帖子同样方式解析。一个请求结构覆盖用户提交的每一类视频。

怎么处理 API 错误？

400 修请求结构，401 修 bearer 密钥，409 按文档化幂等键行为处理。把 502、503、504 当作暂时性上游故障带退避重试。重试前记录状态和错误码，让管线区分坏请求和暂时性问题。