Guides
Sume guides: the API, Formats, agents, models, media tools and pricing, each answer dated and sourced.
Roo Code alwaysAllow for Sume MCP: which tools to auto-approve
Roo Code alwaysAllow skips the approval click. Auto-approve Sume read tools only, and keep paid ones manual or behind dry_run and a spend cap.
Roo Code MCP timeout 60 s default: add Sume as streamable-http
Roo Code defaults MCP requests to 60 seconds and allows 1 to 3600. Here is the streamable-http entry for Sume with a timeout that fits jobs_wait.
Runway credit table vs Sume plan call: know the price first
Runway lists credits per clip on its pricing page. Sume Timeline has an unbilled plan call that returns billable minutes and estimated cost before you render.
script_alignment_mismatch: fixing a caption job with script_text
When script_text does not match the speech, a Sume caption job fails with script_alignment_mismatch or script_alignment_failed. Simplify the script or omit it.
Skippable in-stream has no max length: cut a 6-minute film under 3
Google Ads sets no maximum for skippable in-stream but recommends under 3 minutes. Cut a 6-minute film with Sume trim at $0.02 and find the cut points.
Smallest square GPT Image 2.5 accepts on Sume: 816x816
A small icon request fails at 800x800 on GPT Image 2.5: under 655,360 pixels. 810x810 fails the 16 rule. 816x816 is the smallest legal square.
Smallest video each ad platform accepts, and Sume's 256 px floor
Meta Facebook Feed needs 120 px, Instagram Feed 250 px wide, LinkedIn 360 px, TikTok 540x960. Sume trim and Timeline output cannot go below 256 px.
Timeline soundtrack duck_db: 0 to 20 dB, needs a real audio spine
Sume Timeline soundtrack.duck_db accepts 0 to 20 and returns duck_requires_audio_spine on silence. Use it with a voiceover spine; gain_db covers a static level.
Sume image n: docs say up to 10, every catalog row says 4 or less
The Image API docs say n is 1 to 10, but each catalog row publishes its own ceiling: 4 on most, 1 on Grok Imagine. Cost is cost_usd times n. Table with prices.
Sume MCP insufficient_scope: why it happens and the two ways to fix it
A Sume MCP tool returns insufficient_scope when an OAuth session has mcp:read only. Fix it by re-consenting with Write on, or by using an API key.
Sume MCP jobs_wait with 20 job_ids: wait_for any versus all
jobs_wait takes up to 20 job_ids and wait_for any or all. All is the default. Any returns early, but the other jobs keep running and billing. Examples inside.
Sume 429 queue_full from an MCP agent: wave sizes for Free to Scale
An agent that submits too many paid jobs hits 429 queue_full. Accepted capacity is 6 on Free, 24 on Pro, 48 on Startup, 120 on Scale. Wave sizes inside.
Sume MCP script_run: fan out 3+ calls in one turn, 55 s limit
script_run runs a short JavaScript program on Sume that calls tools in a loop or in parallel. timeout_seconds is 5 to 55. Use it for 3+ similar calls.
Suno Premier credits cost 25% less than Pro: and the Sume math
Suno Pro is $8 for 2,500 credits and Premier $24 for 10,000, so a credit is $0.0032 vs $0.0024. At $0.125 a track, Sume breaks even at 64 or 192 tracks.
Tall 1:3 strip on GPT Image 2.5: 1280x3840 passes, 1280x3856 fails
A tall scroll strip on Sume's GPT Image 2.5 can be 1:3 at most. 1280x3840 is exact and legal; one more row of 16 pixels breaks the 3:1 rule.
Timeline audio concat fails on mono plus stereo: channel mismatch
Joining a mono and a stereo file in Sume timeline audio returns audio_parts_channel_mismatch. Detach both as mono, or match layouts first.
Timeline render_strategy_unsafe: why single fails above 12 slots
Timeline returns render_strategy_unsafe when strategy single is used with over 12 slots. Leave it on auto, which chunks past 12 segments. Limits and the fix.
Timeline too_many_chained_transitions: 8 fades, then a hard cut
Sume Timeline allows at most 8 adjacent fades and returns too_many_chained_transitions past that. Each fade is 1 s or less and 50% of the shorter slot. The fix.
Verify a Sume image webhook in Python, then read artifacts[]
A 23-line Python verifier for Sume's x-sume-webhook-signature header on an image job: refuses an empty secret, checks a 5-minute window, reads the image URL.
verifyWebhook toleranceSeconds 0 turns off the Sume replay check
In @sume-com/sdk, toleranceSeconds defaults to 300 and 0 skips the timestamp check. A runnable test shows an hour-old signed delivery passing only at 0.
wav or mp3 for joined audio: priming padding at every edge
Sume timeline audio outputs wav by default and mp3 as an option. Keep wav if you join again or lip-sync: mp3 adds priming padding at every edge.
Which AI video models make a 20-second clip in one job on Sume?
Seedance 2.5 (4-30 s) and Wan 3.0 (2-30 s) cover 20 seconds in one job on Sume. Omni Flash 1.1 stops at 10 s, MiniMax H3 at 15 s. Full duration table.
Which Sume Formats return images, not video? 9 of the 27 slugs
Of the 27 Formats by Sume, 18 declare video output and 9 declare image output. The slug lists, how to read the io profile, and why to check before you call.
Which Sume submit errors cost money: 402, queue_full, 429, 503
None of them charges you. 402 fails before the reserve, queue_full releases the hold, and rate_limited and 503 mean the job was never accepted.
Which tool exports 4K: Descript, Kapwing, HeyGen, Runway or Sume
4K is a plan tier at Descript, Kapwing and HeyGen. Sume gates it by request: 4K video via sume/auto, timeline edges capped at 2160, avatar video at 720p.
Korean burned-in captions in a CapCut style: Sume Hangul styles
Sume burns Korean captions with six Hangul styles and 29 open-license fonts at $0.20 per clip up to 60 seconds. Latin styles reject Korean with a 400.
Non-skippable YouTube ads: cut a 75-second spot to 60 with Sume
Google Ads lists non-skippable in-stream at 60 seconds or shorter. Drop 15 seconds from the middle of a 75 second spot with Sume detach and Timeline: $0.11.
A 13-scene, 117-second storyboard at 720p: Wan, Seedance, Omni
Thirteen 9-second scenes at 720p cost $14.63 on Wan 3.0, $67.60 on Seedance 2.5 and $14.63 on Gemini Omni Flash 1.1; Omni needs no stitching under 10 s.
A 30-minute voiceover: the 1,800 s Timeline cap and two TTS jobs
A 1,800-second Timeline render costs $3.00 and a 30-minute read exceeds the 20,000-character TTS cap, so it takes two jobs. Per-vendor math, read 2026-10-08.
90-second explainer from fifteen 6-second scenes, plus the render
Fifteen 6 s scenes at 720p cost $11.25 on Wan 3.0 or Omni and $52.00 on Seedance 2.5; the 90 s timeline render adds $0.20 (2 billed minutes at $0.10).
A 12-second webhook handler times out at 10 s: dedupe Sume deliveries
Sume gives each webhook attempt 10 seconds and retries up to 10 times. A 12 s handler gets repeats. Verify, store job_id once, and return 2xx early.
Cheapest 1080p AI video per second on Sume, ranked, 21 s example
At 1080p Omni Flash is $0.1875 a second, H3 Max $0.20, Wan 3.0 $0.25, Seedance 2.0 $0.8505 and Seedance 2.5 $1.42155. A 21 s clip ranges from $3.94 to $29.85.
Cut out 25 product photos from an agent: rmbg_create and jobs_wait
An MCP agent submits 25 rmbg_create calls, waits with jobs_wait in two slices (20 ids, then 5), and pays 25 x $0.0225 = $0.5625. Idempotency keys inside.
Crop 1920x1080 to 9:16 around a left-third subject: x = 0.1751
Video filter crop fractions for an off-center 9:16 strip from a 1920x1080 clip: x 0.1751, width 0.3164, height 1. About $0.02 plus a $0.10 Timeline render.
Eight shots, 2 to 11 s: how each Sume video model bends the plan
A storyboard with shots of 2, 3, 4, 5, 6, 7, 9 and 11 s is 47 s on Wan 3.0 ($5.88 at 720p) but 50 s on Seedance 2.5 and 11 s is out for Omni.
Gemini Flash-Lite TTS lacks 29 languages that Flash covers
Google's table lists 132 languages for Gemini 3.8 Flash TTS and 103 for Flash-Lite, so 29 are Flash-only, including Thai, Swedish and Finnish. Read 2026-10-08.
Before a Recast swap with hired talent: a 4-person release checklist
H3 Max Recast uses one photo per person, up to 4. A process checklist for approvals and YouTube disclosure before you spend $0.375 per second.
Kling motion control: send image_url or avatar_handle, not both
Sume's Kling 3.0 Motion Control takes exactly one visual source: image_url or an avatar_id/avatar_handle. A short Python check before the $0.1575/s submit.
Kling motion control on Sume: keep_original_sound and orientation
Two optional Kling motion control fields on Sume: keep_original_sound defaults to true and character_orientation defaults to video, or image.
MAI-Voice-2.1 ~550 ms vs Flash ~45 ms: does it matter for voiceover?
Microsoft lists ~550 ms and ~45 ms model-inference latency for MAI-Voice-2.1 and Flash. In series, 1,000 lines take 9.2 minutes vs 45 s. Read 2026-10-08.
Photo dance via hosted MCP: kling-motion-control_create needs a key
The hosted MCP exposes kling-motion-control_create as a paid tool that requires an idempotency_key. 8 s of motion control costs 8 x $0.1575 = $1.26.
Which BPM makes a 3 to 10 second Omni clip a whole number of bars?
Gemini Omni Flash 1.1 clips run 3 to 10 seconds. At 120 BPM a 10 s clip is 5 bars; at 128 BPM no whole-second length fits. A table of the BPMs that line up.
Omni Flash references: 10 images, 3 clips of 3 s, 9 s of footage
Gemini Omni Flash 1.1 on Sume takes up to 10 reference images and 3 reference clips of 3 s each (9 s of footage), with no audio reference. Cost: $1.00 for 8 s.
Python: chain generate, cutout and upscale with one polling helper
One Python helper submits any Sume job with mode async, polls status until terminal, and returns the artifact URL. Three calls chain image, RMBG and upscale.
Replace line 7 of 12 voiceover lines: one TTS job and a concat
Fixing one 180-character line of a 12-line voiceover costs $0.02 (one TTS job at the 1-cent floor plus a $0.01 concat) vs $0.12 to redo all 12. Read 2026-10-08.
RMBG costs the same for a 24 MP photo and a 0.5 MP thumbnail
Sume remove-background is $0.0225 per image regardless of size, so resizing before a cutout saves upload time, not money. 600-image arithmetic inside.
480p to 1080p price multiplier: Seedance 5.29x, Wan 4x, Omni 5x
Going from the lowest to 1080p costs 5.29 times more on Seedance 2.5, 4 times on Wan 3.0, 5 times on Gemini Omni Flash (360p) and 3.2 times on MiniMax H3 Max.
Silent 11-second b-roll: Omni rejects generate_audio false
Gemini Omni Flash 1.1 on Sume always has audio and rejects generate_audio false, and stops at 10 s anyway. For 11 s of b-roll, Wan 3.0 at 720p is $1.375.