使用Instagram Graph API的media端点创建媒体容器时遇未知错误求助

问题场景 #

使用Instagram Graph API的media端点，通过公开URL创建图片媒体容器时，始终返回OAuthException(code:1)未知错误，请求及错误响应如下：

请求示例

POST https://graph.facebook.com/v15.0/{your-instagram-business-id}/media
?image_url=https%3A%2F%2Fwww.sample-videos.com%2Fimg%2FSample-jpg-image-100kb.jpg
&is_carousel_item=False
&caption=this%2Bis%2Ba%2Btest
&access_token={your-token}

错误响应

{
   "error":{
      "message":"An unknown error has occurred.",
      "type":"OAuthException",
      "code":1,
      "fbtrace_id":"{unique code}"
   }
}

排查及解决步骤 #

• 修正布尔参数格式：is_carousel_item参数需使用小写的false，Graph API对布尔值的大小写敏感，大写False会被识别为无效参数，触发未知错误。
• 验证图片URL的可访问性：确保Facebook服务器能正常抓取该图片，部分公开URL可能存在防盗链、地区限制或CDN缓存问题。可尝试将图片迁移至无限制的托管服务，或使用工具模拟Facebook的请求头访问该URL，确认能返回完整图片内容。
• 确认权限与账号关联：检查长期令牌是否包含instagram_basic、pages_show_list、pages_read_engagement、instagram_content_publish权限，同时确认令牌绑定的Facebook页面已与目标Instagram商业账号完成关联。
• 简化请求排查参数：先移除caption、is_carousel_item等非必要参数，仅保留image_url和access_token发起请求，确认基础请求是否正常，再逐步添加参数定位问题点。
• 切换API版本：尝试使用最新稳定版API（如v18.0），旧版本可能存在已修复的兼容性bug。

内容的提问来源于stack exchange，提问作者MarGraz