Blog

Media tools

Sume media tools by API: trim, filter, captions, frames, inspect, speech-to-text, upscaling, background removal, transitions, and Timeline assembly.

Start with: Video editing API limits: Sume media tool caps in one table

Crop a 21:9 or 2.39:1 film clip to 9:16 with video filter

Width fractions for cropping ultrawide 21:9, 2.39:1 and 32:9 clips to 9:16 with one Sume video-filter crop op, plus the 0.05 minimum side and a free check.

Transcribe and probe in one call: video-inspect STT at $0.01/min

Add transcribe: true to a video-inspect request for sentence segments and word timings at $0.01 per audio minute. The duration hint, 600 s cap and refusals.

Amazon video ad frame rate: set Sume Timeline fps to 24, 25 or 30

Amazon lists 24, 25 and 30 fps among its rates. Sume Timeline takes 24, 25, 30 or 60. Choose a rate that matches the source to avoid the resample warning.

LinkedIn video ads need under 30 fps: render at 24 or 25 on Sume

LinkedIn's spec says frame rate must be less than 30 fps. Sume Timeline and trim accept 24, 25, 30 or 60, so only 24 and 25 fit. How to set it and check it.

Amazon Sponsored Brands video is 16:9 only: render 1920x1080 on Sume

Amazon lists 16:9 as the only aspect ratio for Sponsored Brands video. Set Timeline output to 1920x1080 at 24 fps and check the plan for free before you pay.

How many words fit a 5 to 14.8 s lip-sync segment: measure first

At the 2.8 words a second Sume's avatar planner assumes, 5 to 14.8 s is 14 to 41 words. TTS pace varies: measure the audio before setting duration_seconds.

Group TTS sentences into 5 to 14.8 second lip-sync segments in Python

A short Python planner that groups sentence durations into segments the Sume H3 Max lip-sync route accepts (5 to 14.8 s) and prints the 768p cost of each.

H3 Max lip sync: 480p drafts then a 1080p final for a 6-second line

A 6-second line costs $0.375 at 480p and $1.20 at 1080p on Sume H3 Max lip sync. Drafting pays only past 1.45 expected attempts. The math, with code.

Test Kling motion control on 3 s: $0.47 before a $4.73 run

Kling motion control on Sume reserves ceil(seconds) x $0.1575. Test with a 3-second motion video ($0.47) before a 30-second run ($4.73). With code.

Holiday music bed under a voice: soundtrack duck_db 0 to 20

Sume Timeline takes a soundtrack bed with gain_db, loop, fade_out_seconds up to 10 and duck_db 0 to 20 under a voice spine. Python plan call and errors.

LinkedIn ratios 1:1, 4:5, 9:16: Sume video-filter crop fractions

LinkedIn lists 16:9, 1:1, 4:5 and 9:16 video. Centered crop fractions for a 16:9 or 9:16 source, plus a short Python function that prints the video-filter ops.

Move burned captions: design.placement.anchor_ratio on Sume

Sume caption styles have default heights. Send design.placement.anchor_ratio to move the line, as a fraction of frame height. Which styles accept it.

One portrait, three languages: three 6-second lip-sync jobs for $1.80

A greeting in English, Spanish and Polish from one still: three 6-second H3 Max 768p jobs cost $1.80 plus TTS. Steps, the language check and limits.

45-second voice-over: four H3 Max segments, $4.80, or one Fabric job

A 45-second line must be four H3 Max lip-sync segments (about $4.80 at 768p) or one Fabric 1.0 job (about $8.44 at 720p). What each route allows and costs.

Amazon Sponsored Brands video: cut a 20-second window with Sume trim

Amazon lists 6 to 45 seconds for Sponsored Brands video and prefers 20 or less. Use Sume video trim to cut an exact range from a longer clip for $0.02 a job.

Omni edit loop on Sume: three instructions, three jobs, about $3.00

Editing a clip with Gemini Omni one instruction at a time is one Sume job per pass. If each pass returns 8 s at 720p, three passes cost $3.00.

One 1920x1080 master to TikTok 9:16, 1:1 and 16:9 ads: $0.04

TikTok's page lists three ratios with minimum sizes. From one 1920x1080 clip, two video-filter crops make 9:16 and 1:1 at $0.02 each. The fractions are shown.

Black Friday supercut in Timeline: 12 segments vs auto chunking

Timeline accepts up to 200 video slots. A single strategy is refused above 12 segments (render_strategy_unsafe); auto chunks the render past 12.

Mixing 24 fps Seedance clips with 30 fps footage in Sume Timeline

Set output.fps to 24, 25, 30 or 60 in Timeline 1.0. If you omit it, the job matches the sources, and a mismatch returns output_fps_resamples_sources.

Captions on a 3-minute Short: Sume's $0.20 covers 60 s, plan three

Sume's standalone caption job is $0.20 for videos up to 60 seconds. A 180 second Short, the YouTube ceiling, means three cuts, so plan about $0.96 all in.

Crop a 10-minute 16:9 ad to 9:16: filter stops at 300 s, so split

Sume video filter takes sources of 300 seconds or less; TikTok non-Spark ads run to 10 minutes. Two trims, two crops and a timeline cost $1.08. The steps.

Is a 180 second video still a YouTube Short? Trim to 179.5 for margin

YouTube's Shorts page says up to 3 minutes. It says nothing on rounding, so cut to 179.5 s with Sume video trim (duration accepts decimals, $0.02 a job).

Korean Black Friday captions: korean-ad style, $0.20 per clip

Burn Korean captions with style korean-ad or black-outline and language ko for $0.20 per clip up to 60 s. A Latin style with Hangul text returns 400.

TikTok safe zone captions: anchor_ratio and safe_width_ratio on Sume

TikTok's ad page says safe zones vary by orientation and caption length and ships reference files. Sume's caption design fields move the line; ranges listed.

Timeline refuses more than 8 chained fades: countdown cut fix

Sume Timeline 1.0 refuses more than 8 adjacent fades with too_many_chained_transitions. Alternate hard cuts and fades in a 12-clip holiday countdown.

Transparent sticker: GPT Image 2.5 background field or Nano Banana 2.1

Only GPT Image 2.5 lists a background field on Sume. Nano Banana 2.1 does not, so a transparent PNG there is $0.10 plus a $0.0225 background-removal step.

Trim a 4-minute video to a 180 s YouTube Short: start 30, duration 180

YouTube's Shorts page allows up to 3 minutes. Sume video trim cuts 180 seconds from a 240 second source for $0.02. The request, the limits and the refusals.

1:1 clip on a 540x960 TikTok canvas: cover, contain or blur

A 1080x1080 clip on a 540x960 Timeline canvas: contain leaves 210 px bars top and bottom, cover cuts 420 px, blur fills the bars. All cost $0.10 a minute.

Crop 1920x1080 to 9:16: video-filter width 0.3164, x 0.3418

To get a 9:16 strip from a 1920x1080 clip, send a Sume video-filter crop with x 0.3418, y 0, width 0.3164, height 1: about 608x1080, above TikTok's 540x960.

Music bed shorter than the voiceover: loop, fade and duck in Timeline

If a Music 1.0 bed ends before your narration, Sume's Timeline soundtrack can loop it, fade out up to 10 seconds and duck 0 to 20 dB under speech. The settings.

90 s Audio Library song in a 3-minute Short: what covers the rest

YouTube lets a Shorts Audio Library song play up to 90 s in a 3-minute Short. Sume Music 1.0 is $0.125 a track; Timeline loops a bed for $0.30.

Extract the first 90 seconds of a video's audio: audio-detach range

Send audio-detach range {start 0, end 90} for $0.01: 17.28 MB as 48 kHz stereo wav or 1.44 MB as 128 kbps mp3, a Shorts Audio Library song's 90 s.

Keyframe or exact trim for a TikTok ad: which keeps 516 kbps?

Sume video-trim exact re-encodes with libx264; keyframe copies the stream. You cannot set bitrate, so measure size / duration against TikTok's 516 kbps floor.

Crop a 21:9 video to 9:16, 4:5, 1:1 and 16:9: fraction table

From a 21:9 source, a full-height crop is 0.2411 wide for 9:16, 0.3429 for 4:5, 0.4286 for 1:1, 0.7619 for 16:9. $0.02 per crop; the check is free.

Caption a 75-second clip: the $0.20 estimate is for 60 seconds

Sume's standalone caption job lists $0.20 for videos up to 60 seconds. For a 75-second clip, read the live catalog price or split the cut first. Budget table.

Five caption looks on one clip: one transcription, four restyles

Test five caption styles on one video for $1.00: the first job transcribes, four source_caption_id restyles reuse the word timings. Request bodies included.

Join 20 voice lines: audio.parts in the render, or a $0.01 audio job

Timeline 1.0 takes up to 20 audio.parts in one render. A Timeline audio job joins up to 20 parts for $0.01 and returns offsets. Which to use; 45 lines.

Kling 3 mute plus a Music 1.0 bed: $1.625 vs $2.10 with sound

A 10 s 9:16 Kling 3 clip is $1.40 mute or $2.10 with sound. Mute, one Music 1.0 bed ($0.125) and a $0.10 Timeline render total $1.625, 47.5 cents less.

Brand-color captions: punch and tiktok-green skip design

Sume's docs say punch and tiktok-green read none of the design tokens. To change a caption color per request, use slam or a Hangul style. Token groups.

Restyle captions four ways for 80 cents without transcribing twice

Each Sume caption render is $0.20, so four styles of one clip cost $0.80. A restyle with source_caption_id reuses the word timings and skips re-transcribing.

Three 61-second renders cost $0.60; one 183-second render costs $0.40

Timeline 1.0 rounds each render up to a whole minute at $0.10. Three 61 s renders bill 6 minutes; one 183 s render bills 4. A YouTube Shorts length check too.

Timeline output fps: omit it to follow your clips, or get a warning

Leave output.fps out and Timeline 1.0 follows your longest video sources. Force 30 on 24 fps clips and the job warns output_fps_resamples_sources.

A 7:30 Timeline render bills 8 minutes: cut 30 s to save $0.10

Timeline 1.0 charges $0.10 per ceil(output minute). A 450-second render is 8 minutes, $0.80; trimming it to 420 seconds bills 7 minutes, $0.70. Table and code.

24 character stills on gpt-image-2.5: 24c low, 48c medium, $1.68 high

If you omit quality, gpt-image-2.5 defaults to high. 24 stills (8 characters, 3 poses) cost 24c at low, 48c at medium and 144 to 168c at high on Sume.

A 30-second music bed under a 70-second render costs $0.325

One Music Router track at $0.125 plus a 70-second Timeline render at $0.20 is $0.325. Use soundtrack loop, fade_out_seconds up to 10 and duck_db 0 to 20.

A 1.5-second clip allows a 0.75-second fade: Timeline limits

Timeline 1.0 caps a transition at 1 second and 50% of the shorter neighbor clip. Table of the maximum fade for 0.5 to 4 second clips, plus the refusal codes.

Caption a 45-second reel for 20 cents: script_text or speech-to-text

A standalone Sume caption job is $0.20 for a clip up to 60 seconds, so a 45-second reel is 20 cents. Send script_text to keep your exact wording.

Korean ad captions on a 30-second spot: korean-ad style, $0.20

Use style korean-ad with language ko for CapCut-style Hangul karaoke captions. A standalone caption job is $0.20 for a clip up to 60 seconds.