Media & video

By the end of this page your images, GIFs and videos are within X's limits. You also know what platformSpecificData.longVideo changes on a Premium account.

You need a connected X account (accountId) and media on a public HTTPS URL, or an upload through the media endpoint.

Media requirements

A post carries up to 4 images, or 1 GIF, or 1 video. Files above the size limits are rejected.

Images

GIFs

Videos

Recommended encoding:

• 1280 x 720 px (720p), 16:9 or 1:1
• 30 fps
• H.264 video
• AAC audio at 128 kbps

Attach an image or a video

Media rides on the base request. Put the files in mediaItems and X gets them with the post.

No X-specific field is involved.

import Zernio from '@zernio/node';

const zernio = new Zernio();

const { data: published } = await zernio.posts.createPost({
  body: {
    content: 'Ship notes for 2.4',
    mediaItems: [
      { type: 'image', url: 'https://cdn.example.com/release.png' }
    ],
    platforms: [
      { platform: 'twitter', accountId: '66b2e19d8c3f5a7e9d0b1c2d' }
    ],
    publishNow: true
  }
});

console.log(published.post.platforms[0].platformPostUrl);

Response (201):

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "platforms": [
      {
        "platform": "twitter",
        "status": "published",
        "platformPostUrl": "https://twitter.com/acmecorp/status/1852634789012345678"
      }
    ]
  }
}

Swap type: "image" for type: "video" to post a video.

Up to 4 images go in one post. A GIF or a video takes the slot on its own.

Long video uploads

platformSpecificData.longVideo: true uploads the video with X's amplify_video media category instead of the standard tweet_video.

It is not what allows a long video. The standard path already publishes videos well past 140 seconds, on free accounts included.

Zernio applies it only when the connected X account has a paid X subscription. On other accounts, the flag is accepted and ignored.

The maximum duration is set by X per account, not by Zernio, which enforces only the 512 MB file size.

Some accounts also need X's long-video API allowlisting. Without it, X rejects an amplify_video upload.

const { data: longVideoPost } = await zernio.posts.createPost({
  body: {
    content: 'Full keynote recording',
    mediaItems: [{ type: 'video', url: 'https://cdn.example.com/keynote.mp4' }],
    platforms: [{
      platform: 'twitter',
      accountId: '66b2e19d8c3f5a7e9d0b1c2d',
      platformSpecificData: { longVideo: true }
    }],
    publishNow: true
  }
});

console.log(longVideoPost.post.platforms[0].platformPostUrl);

Response (201):

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "platforms": [
      {
        "platform": "twitter",
        "status": "published",
        "platformPostUrl": "https://twitter.com/acmecorp/status/1852634789012345678"
      }
    ]
  }
}

Media URLs

A media URL must:

• be public HTTPS
• return the file bytes with the correct Content-Type
• not redirect to an HTML page

Google Drive, Dropbox, OneDrive and iCloud sharing links return a web page and fail.

The media uploads guide has the rules and the upload flow.

If it fails

This 207 means Zernio could not download the file from the URL. post.status is "failed", with errorMessage: "Media fetch failed, retrying... (failed after 3 attempts)":

{
  "message": "Post created but publishing failed",
  "error": "All platforms failed",
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "failed",
    "platforms": [
      {
        "platform": "twitter",
        "status": "failed",
        "errorMessage": "Media fetch failed, retrying... (failed after 3 attempts)"
      }
    ]
  }
}

Open the URL in an incognito window. A web page instead of the raw file means the host is not serving the bytes.

Upload the file through the media endpoint and create the post again.

Related

• Posts & Editing: attaching media to the base request.
• Media uploads: presigned uploads up to 5 GB.
• Fields, Geo & Polls: geoRestriction and sensitiveMedia apply to attached media.
• Limits & Errors: every field and error.