登录开始免费试用
easyCoexistence 官方 API

通过 API 发布 Instagram 限时动态

Instagram API 通过公开 URL 上的一张图片或一段视频发布限时动态:使用 media_type 设为 STORIES 创建媒体容器,然后发布。图片为 JPEG 格式,最大 8 MB;视频时长 3 到 60 秒,最大 100 MB。Meta 建议使用 9:16 画面,限时动态在 24 小时后消失,与应用内一致。

easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 publish_instagram_post 发布图片和视频限时动态,并可通过其内置队列进行排期。

60 s

API 可发布的最长限时动态视频;最短为 3 秒,文件最大可达 100 MB。

8 MB

最大的限时动态图片,必须为 JPEG 格式。

24 hours

已发布的限时动态在过期前保持显示的时长。

Under 5

指标值低于 5 时,返回错误代码 10(观看人数不足),而非数字。

限时动态如何发布?

与发布任何帖子使用相同的两个调用。发送 POST /<IG_ID>/media 请求,将 media_type 设为 STORIES,并指定 image_url 或 video_url,然后发送 POST /<IG_ID>/media_publish 请求,并附上容器 ID。视频限时动态需先完成处理,其容器的 status_code 必须显示 FINISHED,才能发布。

Meta 的参考文档描述了图片、视频和轮播的文案,但未描述限时动态的文案,因此需要传达给观众的文字应放在图片或视频本身之中。

限时动态的媒体要求是什么?

Meta 建议限时动态的图片和视频均使用 9:16 画面,以避免裁剪或出现空白。

  • 图片:JPEG 格式,最大 8 MB,使用 sRGB 色彩空间;其他色彩空间将被转换。
  • 视频:MOV 或 MP4 格式,视频编码为 H.264 或 HEVC,音频为 AAC,每秒 23 至 60 帧,宽度最大 1920 像素,码率最高 25 Mbps。
  • 视频时长:3 至 60 秒,文件最大 100 MB。
  • 视频宽高比:0.1:1 至 10:1 之间的任何比例均可接受。

限时动态可以包含什么?

图片或视频本身,以及对其他账户的提及:自 2025 年 7 月起,user_tags 参数可在图片和视频限时动态中标记公开账户,x 和 y 坐标可选。Meta 不支持通过 API 发布贴纸,链接、投票和位置等贴纸只能在应用内添加。

发布后会发生什么?

限时动态将保留 24 小时,然后与应用内一样过期。Meta 将正在显示的限时动态列在单独的 stories 边缘上;账户的媒体列表 GET /<IG_ID>/media 不包含它们。读取时,限时动态的 media_type 为 IMAGE 或 VIDEO,与其他任何媒体相同,因此应通过查找来源而非类型来区分限时动态。

回复和提及如何返回?

以私信的形式返回。对限时动态的回复会通过 messages Webhook 作为私信送达账户,并附带该限时动态的 ID 和 URL,同时开启常规的 24 小时回复时间窗口。当有人在自己的限时动态中提及该账户时,也会以消息形式送达,附件类型为 story_mention。Meta 的 Mentions API 不涵盖限时动态。

限时动态会报告哪些指标?

触达人数、观看次数、分享次数、回复数、关注数、主页访问次数、主页活动、导航、链接点击次数、转发次数及总互动数,均通过媒体洞察端点读取。这些指标仅保留 24 小时,若某项数值低于 5,将返回错误代码 10(观看人数不足),而非具体数字。来自欧洲和日本的回复不计入统计,在这两个地区的账户所创建的限时动态会报告 0 条回复。

常见错误

  • 计划添加链接贴纸。API 不发布贴纸,因此链接必须通过其他方式送达用户,例如通过私信回复。
  • 次日才读取限时动态指标。这些指标仅保留 24 小时,因此应在限时动态显示期间收集。
  • 在账户的媒体列表中查找已发布的限时动态。正在显示的限时动态列在单独的 stories 边缘上。
  • 将横屏视频发布为限时动态。Meta 建议使用 9:16,其他比例可能出现空白或被裁剪。
使用 EasyCoexistence 完成这些操作

限时动态的回复以私信形式送达,可转发至您的端点,或由自动化功能回复。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

可以通过 API 为限时动态添加链接贴纸吗?

不可以。Meta 不支持通过 API 发布贴纸,包括链接、投票和位置贴纸。提及其他账户(不使用贴纸)则受支持。

API 中在哪里可以找到已发布的限时动态?

在账户单独的 stories 边缘上,前提是限时动态仍在显示。GET /<IG_ID>/media 不包含限时动态,读取时限时动态显示为 IMAGE 或 VIDEO。

限时动态能否通过 API 添加文案?

不。Meta 的参考文档未描述限时动态的文案,publish_instagram_post 发送限时动态时同样不带文案,因此需要传达给观众的文字应放在图片或视频本身之中。

限时动态洞察数据保留多久?

24 小时。Meta 仅在这段时间内提供限时动态指标,因此应在限时动态显示期间读取。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间