Zernio
APIFor you
Zernio
APIFor you
Platforms

YouTube

Overview

Publish

Videos & ShortsMedia RequirementsTranscripts & Captions

Engage

AnalyticsInbox

Reference

Limits & Errors
Dashboard
OverviewPlatformsAPI ReferenceResources
YouTube

Media Requirements

Video and custom thumbnail requirements for YouTube, and the rules for media URLs.


Files above these limits are rejected:

  • 256 GB per video
  • 15 minutes on an unverified channel
  • 2 MB per thumbnail after compression

Large videos (1 GB or more) can take 30 to 60 minutes or longer to process on YouTube's side.

The video shows a "processing" state meanwhile, so do not retry the upload.

Videos

PropertyShortsVideo
Max duration3 minutes12 hours (verified), 15 minutes (unverified)
Min duration1 second1 second
Max file size256 GB256 GB
FormatsMP4, MOV, AVI, WMV, FLV, 3GP, WebMMP4, MOV, AVI, WMV, FLV, 3GP, WebM
Aspect ratio9:16 (vertical)16:9 (horizontal)
Resolution1080 x 1920 px1920 x 1080 px (1080p)

Recommended encoding:

PropertyShortsVideo
Resolution1080 x 1920 px3840 x 2160 px (4K)
Frame rate30 fps24 to 60 fps
CodecH.264H.264 or H.265
AudioAAC, 128 kbpsAAC, 384 kbps
Bitrate10 Mbps35 to 68 Mbps (4K)

Custom thumbnails

Custom thumbnails work on videos only, not Shorts. Set thumbnail on the video media item.

PropertyRequirement
FormatJPEG, PNG, GIF
Max size2 MB
Recommended resolution1280 x 720 px (16:9)
Min width640 px

Zernio enforces YouTube's rules before upload: JPEG, PNG or GIF, and 2 MB at most. Oversized images are compressed first, and rejected if they are still over 2 MB.

YouTube itself only accepts custom thumbnails on phone-verified channels (youtube.com/verify).

Unverified channel. The video still uploads and publishes; only the thumbnail is skipped.

Zernio remembers the refusal for 7 days and does not retry thumbnails on that channel until then. After verifying, allow up to a week for thumbnails to resume.

Media URLs

The URL must return the video bytes, not an HTML page, with no authentication and no expired link.

Or upload through the media endpoint.

Was this page helpful?

Videos & Shorts

Publish a video or a Short to YouTube, add it to a playlist, schedule it, edit a published video, and every platformSpecificData field.

Transcripts & Captions

Read the caption track of a connected channel's own video to get its transcript.

On this page

VideosCustom thumbnailsMedia URLs