SNS動画リサイザー

resize-video

Use Social Video Resizer through the Zavilo SDK. Check input limits, parameters, output and supported modes below.

H · HeadlessI · InteractiveE · Embedded

Tool IDresize-video

バージョン1

実行方式CLIENT

対応モードHeadless, Interactive, Embedded

クイック操作

入力ファイル 1出力ファイル 1–4

結果処理ガイド → レシピ → 統合サンプル → Playground →

入力

この Tool が受け付ける入力形式とファイル数です。

入力種類	file
ファイル数	1 – 1
対応 MIME	video/mp4, video/webm, video/quicktime

パラメータ

これらの値は request.options で渡します。

パラメータ	型	必須	既定値	許可値 / 範囲	説明
`targets`	enum[]	任意	—	—	Social output presets to generate. vertical=1080×1920 (9:16 TikTok/Reels/Shorts), portrait=1080×1350 (4:5 feeds), square=1080×1080 (1:1), landscape=1920×1080 (16:9). Multiple values generate multiple MP4 files.
`layout`	enum	任意	`auto`	auto \| fill \| fit \| blur	How the source fits each target. auto fills when aspect ratios are close and switches to a blurred background for large ratio changes; fill may crop; fit preserves the entire source with padding; blur preserves the entire source over a blurred background.
`cropFocus`	enum	任意	`center`	center \| top \| bottom \| left \| right	Crop anchor used by fill/auto when cropping is required. This is a fixed framing anchor, not AI subject tracking.
`quality`	enum	任意	`balanced`	high \| balanced \| small	Encoding quality preset. high favors visual quality, balanced is the default tradeoff, small favors smaller files.
`keepAudio`	boolean	任意	`true`	—	Keep the original audio track when one is present. false exports silent video.
`width`	integer	任意	—	2 – 7680	Legacy custom-size output width in pixels. Used only when targets is omitted and either width or height is supplied.
`height`	integer	任意	—	2 – 4320	Legacy custom-size output height in pixels. Used only when targets is omitted and either width or height is supplied.
`keepAspectRatio`	boolean	任意	`true`	—	Legacy custom-size behavior. Preserve source aspect ratio inside width/height. Ignored when targets is supplied.

出力

処理完了後に返される結果形式です。

型	files+data
ファイル数	1 – 4
出力 MIME	video/mp4
Metadata	duration, sourceWidth, sourceHeight, outputCount, inputBytes, outputBytes, targets, layout, quality, keepAudio
ZIP アーカイブ	対応 · threshold 2

基本例

対応する統合モードを確認し、生成された開始コードをコピーできます。

Headless

const result = await client.run("resize-video", {
  file,
  options: { layout: "auto", cropFocus: "center", quality: "balanced" }
});
console.log(result.files, result.data, result.metadata);

Interactive

await client.open({
  tool: "resize-video",
  input: { file },
  options: { layout: "auto", cropFocus: "center", quality: "balanced" },
  onComplete(result) { console.log(result.files, result.data, result.metadata); }
});

Embedded

await client.mount({ tool: "resize-video", target: "#zavilo-tool", mode: "embedded" });

This page is generated from the SDK Tool Definition used by the runtime.