Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.letmepost.dev/llms.txt

Use this file to discover all available pages before exploring further.

What it checks

byteLength <= 2_000_000_000 for resolved video bytes.

Why

Pinterest’s video upload spec puts the per-upload ceiling at ~2 GB. Going over surfaces as a registration failure or an S3 upload reject — neither maps cleanly to an actionable error.

Failure response

{
  "error": {
    "code": "preflight_failed",
    "rule": "pinterest.video.size_max",
    "platform": "pinterest",
    "message": "Video is 2400000000 bytes; Pinterest allows at most 2000000000.",
    "remediation": "Compress under 2000000000 bytes (~2 GB)."
  }
}

Remediation

Drop the bitrate. For 1080p H.264, 5 Mbps is typically enough:
ffmpeg -i input.mp4 -c:v libx264 -b:v 5M -c:a aac -b:a 128k -movflags +faststart output.mp4
For very long clips, split into multiple pins or trim the video.