Skip to content
nitida

UploadVideoOptions

type UploadVideoOptions = {
  hls?: boolean;
  passthrough?: boolean;
};

Defined in: packages/sdk/src/index.ts:401

VIDEO-only delivery knobs threaded into /assets/process. Ignored for image / audio / other uploads. Both fields default to today’s behavior when omitted, so existing callers are unaffected.

Properties

Section titled “Properties”

hls?

Section titled “hls?”
optional hls?: boolean;

Defined in: packages/sdk/src/index.ts:408

false → skip the auto-dispatched HLS adaptive ladder (240p–2160p). Use for download-only assets served as a progressive -v.mp4 and never streamed (e.g. share-video reels) — it avoids a second Cloud Run Job no one watches. Default/absent → the ladder is generated as before.

passthrough?

Section titled “passthrough?”
optional passthrough?: boolean;

Defined in: packages/sdk/src/index.ts:417

true → when the uploaded MP4 is ALREADY web-safe (H.264 + yuv420p), re-mux the video variant with -c copy instead of re-encoding. Use for delivery-ready uploads (the bytes are already H.264 High / yuv420p / +faststart / capped bitrate) to skip a wasteful re-encode + generational quality loss. Falls back to a full re-encode automatically when the source is not web-safe. Default/absent → unconditional re-encode (today’s path).