X API Post attach rule: 4 photos, 1 GIF or 1 video
An X Post takes up to 4 photos, or 1 animated GIF, or 1 video. A Sume image call can return 1 to 4 images, which matches the 4-photo ceiling.

X says you may attach up to 4 photos, 1 animated GIF or 1 video in a Post, and not a mix. Sume's image routes take n or num_images from 1 to 4, so one call can fill a four-photo Post; the image docs list no GIF output format.
The attach rule is from X's Media best practices page, read 2026-10-01. Sume facts are from Image API and Image 1.0.
What is the attach rule?
The page states "up to 4 photos, 1 animated GIF or 1 video in a Post". It also says upload and Post-create limits are separately enforced, so a media_id that finalized can still be rejected by POST /2/tweets.
| Media | Max in one Post |
|---|---|
| Photos | 4 |
| Animated GIF | 1 |
| Video | 1 |
How many images can one Sume call return?
The image catalog entry for bytedance-seed/seedream-4.5 shows n as a range from 1 to 4, and Image 1.0 documents num_images as an integer from 1 to 4. Each output gets a durable media.sume.com URL. Ask for four, review them, and attach the ones you keep.
Which ratio suits a feed Post?
Image 1.0 notes that 4:5 is Instagram portrait (1080 by 1350), not 4:3, and aspect ratios are a per-model catalog, so check what your model accepts. X's page does not give a photo aspect ratio, so this is a choice for your layout, not an X requirement.
What about a GIF or a video in the same Post?
They exclude photos. The Sume image formats listed for the catalog entry are png, jpeg and webp, so animated output comes from video, not from the image routes. For the GIF limits and an MP4 alternative see X animated GIF limits.
Sources
Related posts
More in Use cases
- X Premium 125-minute Post video vs Sume 900-second trim output
Premium or verified X accounts can post 125 minutes and 16 GB. A single Sume trim outputs at most 900 seconds, so here is where each runtime fits.
- X video 720x1280 portrait and 1080p playback: conform with trim
X recommends 1280x720, 720x1280 and 720x720, with 1080p playback for subscribed users and 720p otherwise. Sume trim conforms size from 256 to 2160.
- YouTube A/B testing three cuts: render the variants by API
YouTube Studio can test up to three cuts of a video. To make the cuts, trim one source three ways and render each with Timeline; here is what that costs.
- YouTube: AI podcast hosts giving financial advice and monetizing
YouTube lists AI-generated podcast hosts offering financial guidance, investment tips or wealth management advice as not allowed to monetize.
Written by Sume