使用Pinterest API上传媒体始终处于registered状态的求助

可能的原因及对应解决方案 #

• S3链接无法被Pinterest服务器访问
  你提供的S3视频链接必须确保Pinterest服务器能直接发起GET请求获取文件：

  • 若为公开S3对象，检查桶权限策略是否允许外部读取；
  • 若为预签名链接，确认链接有效期足够覆盖处理时长，且签名包含GET操作权限；
  • 用curl直接测试该S3链接，验证是否能正常下载视频，排除本地网络或权限限制问题。

• 视频不符合Pinterest格式规范
  Pinterest对视频有明确要求，不符合则无法完成处理：

  • 格式：必须为MP4；
  • 编码：视频用H.264，音频用AAC；
  • 分辨率：最小640x360，最大4096x4096；
  • 时长：4秒至15分钟；
  • 文件大小：最大2GB。
    建议用FFmpeg等工具检查并转换视频至符合要求的格式。

• API请求参数缺失或不规范
  补充可选参数可帮助Pinterest更快完成处理：

  • 添加poster_image_url参数，提供符合要求的封面图链接（JPG/PNG格式，最小600x600像素），避免因无法抓取视频帧导致流程卡住。
    修正后的请求示例：

  curl --location --request POST 'https://api.pinterest.com/v5/media' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "media_type": "video",
      "upload_url": "amazon s3 video link",
      "poster_image_url": "amazon s3 cover image link"
  }'
  

• 权限或令牌问题
  确认访问令牌包含media:write和pins:write权限范围，权限不足可能导致处理流程中断，可通过令牌验证接口确认权限完整性。

• 临时服务器或网络异常
  重新发送媒体注册请求，生成新的media_id后再次查询状态，排除Pinterest服务器临时故障或初始请求传输异常的情况。

额外提示 #

若以上方法无效，可尝试使用Pinterest的直接分块上传方式替代URL拉取：

1. 调用POST /v5/media获取上传地址；
2. 将视频分块上传至返回的上传URL；
3. 通知Pinterest上传完成，触发媒体处理流程。

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