Guides
Sume guides: the API, Formats, agents, models, media tools and pricing, each answer dated and sourced.
Sume submit response: the sync object is null on async and webhook
In a Sume job envelope, data.sync is null for async and webhook modes. Check it for null before you read timed_out or capacity_exhausted.
Claymation look test: four Sume video models at low resolution
Test a claymation prompt on Omni Flash 1.1, Wan 3.0, H3 and Seedance 2.0 Mini for under $1.20 in drafts, then price the finals at 1080p before committing.
Haystack MCPTool 30-second timeout vs Sume jobs_wait holds
Haystack's MCPTool times out tool calls at 30 seconds; Sume's jobs_wait holds 50 to 55. Raise invocation_timeout or wait in shorter slices.
Product turntable 1:1: Wan 3.0 draft at 480p, final at 1080p
An 8-second square turntable on Wan 3.0 costs $0.50 at 480p and $2.00 at 1080p on Sume, so five drafts plus one final is $4.50, not six finals.
Bulk queue window math: 8 gift clips at concurrency 3
With 8 items and concurrency 3, a Sume bulk queue starts 3 runs and holds 5. See how the window drains as each gift clip finishes, fails, or is canceled.
Video inspect on Sume: 8 stills at 768 px and the fast seek option
Sume video inspect returns 8 mid-bin stills at a 768 px long edge by default, up to 24 stills, and a fast seek mode that can land one GOP early.
Burn a free-shipping cutoff onto a finished clip with caption cues
Burn a free-shipping cutoff line onto a finished holiday clip using Sume video-captions cues: text, start, and end in seconds, no speech needed, $0.20 a job.
One narrator across a series: Sume TTS 1.0 is Sonic 3.6, pin older ids
Sume TTS 1.0 always runs on sonic-3.6. To keep a series that began on an older Sonic, use the TTS Router and pin sonic-3.5 or sonic-3 with the same voice.
6-second ad legal line: Sume TTS speed 1.5 and checking word times
A fast legal read tops out at generation_config.speed 1.5 on Sume TTS. Read the word timings to see whether the line fits your 6 seconds, then cut words.
Why every AI background track sounds the same: a seven-axis brief
If your AI music all sounds alike, the prompt is probably generic. Sume's Lyria brief has seven axes: emotion, genre, BPM, key, instruments, arc and era.
Haystack MCPTool with StreamableHttpServerInfo and Sume MCP
Connect Haystack to Sume's hosted MCP with MCPTool and StreamableHttpServerInfo: a url, an Authorization header, one tool per MCPTool, and what to call first.
VoltAgent MCPConfiguration: connect to the Sume hosted MCP server
VoltAgent's MCPConfiguration takes type http, a url and requestInit headers. Reach Sume at mcp.sume.com/mcp with an API key, then pass tools to an agent.
Sume webhook Redeliver gets a fresh signature: dedupe on job_id
Redeliver re-POSTs a job's real terminal event with a new timestamp and signature, so dedupe on job_id and event, never on the signature or timestamp.
Is a 4:5 or 3:4 video a YouTube Short? Render 1080x1350 or 1080x1440
YouTube says Shorts are square or vertical, up to 3 minutes. 4:5 and 3:4 are taller than wide; render them as 1080x1350 or 1080x1440 with Sume Timeline.
Real estate twilight sky swap with Omni Flash edit: price
Send a listing clip and a prompt to Gemini Omni Flash 1.1 edit on Sume. Resolution defaults to 720p; a 5-second source costs $0.63, or $0.94 at 1080p.
Yoga studio 3:4 portrait promo, 8 seconds: models and price
Wan 3.0, H3 and Seedance list 3:4 on Sume; an 8-second 720p portrait clip costs $1.00 on Wan, $0.60 on H3 (768p) and $4.63 on Seedance 2.5.
Product colorway grid: one n=4 call or four calls? Same price on Sume
Four colorways of one product cost $0.20 on Seedream 4.5 whether you send one n=4 call or four calls. What differs is failure shape and idempotency keys.
Square and vertical Shorts series episodes: allowed, keep one size
YouTube's Shorts series accepts portrait or square episodes up to 180 seconds. Render a whole season at one Timeline output size so the feed stays consistent.
30-second AI video ad: Magnific credits vs Sume dollars, three models
A 30-second AI video ad costs $1.78 to $13.20 in Magnific credits and $4.20 to $17.33 on Sume, depending on model. Three models, priced from both pages.
Sume Format webhook: verify the timestamp, register the final URL
Sume signs format.run.terminal with HMAC-SHA256, expects a response in 10 seconds, retries up to 10 times and does not follow redirects. Register the final URL.
Is there a Sume Python SDK? No: use requests and the OpenAPI schema
Sume documents a TypeScript SDK, @sume-com/sdk, and no Python package. From Python, call the REST API with requests, or generate a client from the OpenAPI JSON.
A 15-second Reel at 128 BPM is eight bars: put tempo in the prompt
At 128 BPM in 4/4, eight bars last exactly 15 seconds. Write the BPM and a named moment into the Sume music prompt, then check the audio: BPM is a direction.
Log segment count and billable minutes per holiday ad
Read segment_count, billable_minutes, and warnings from each Sume timeline render result and log one cost line per holiday ad. A Python script, no network.
Online course intro bumper: 6 seconds at 1080p on Sume
A 6-second 1080p course intro costs $0.84 to $8.53 on Sume: Kling 3 silent, Omni Flash 1.1, H3 Max, Wan 3.0, and Seedance 2.5 priced from the catalog.
Ski resort snow report clip: 6 seconds at 1080p on Seedance
A 6-second 1080p clip costs $4.09 on Seedance 2.0 Fast, $5.11 on Seedance 2.0 and $8.53 on Seedance 2.5 on Sume. Wan 3.0 is $1.50.
Manus Custom MCP Servers: add Sume under Settings > Integrations
In Manus, open Settings > Integrations > Custom MCP Servers > Add Server and enter Sume's HTTPS endpoint and credentials. Manus verifies by fetching tools.
v0 custom MCP: connect Sume with a Bearer token or OAuth
In v0, open the + menu, choose MCPs, add a custom MCP and pick Bearer Token or OAuth for auth. Which to use for Sume's hosted server, and what each grants.
YouTube Shorts: upload 15 at a time, so render in batches of 15
YouTube Studio lets you pick up to 15 Shorts per upload. Render a batch of 15 vertical files with Sume Timeline, and see what 15 shorts cost by length.
Slide-up transitions for a vertical Short: Sume Timeline types, limits
Sume Timeline has six transitions, including slideup and slidedown that suit a vertical scroll. Each is at most 1 second and half the shorter clip.
Coffee shop window screen: 15-second 9:16 clip at 1080p
A 15-second 1080p vertical clip for a shop screen costs $2.10 to $21.32 on Sume: Kling 3, H3 Max, Wan 3.0, Seedance 2.0 and 2.5. Omni Flash stops at 10 seconds.
Museum kiosk 4:3 video: which Sume models list the ratio
Wan 3.0, H3, H3 Max and Seedance list 4:3 on Sume; Omni Flash 1.1 and Kling 3 do not. A 10-second 720p clip costs $0.75 to $5.78.
Magnific Gemini Omni 1.1: 720 credits per 3 s in dollars vs Sume
Magnific lists Gemini Omni 1.1 at 720 credits per 3 seconds: $0.16 to $0.24 a second. Sume bills it $0.125 (720p) or $0.1875 (1080p), audio included.
Sume job status logs_available is false: read events_url instead
A Sume job status carries logs_available, false while diagnostics live behind events_url. Read the events timeline for the lifecycle, not inline logs.
Griffin leads DOVER, FID, THEval: pull frames to judge a clip
Tavus ranks Griffin-Lite first on DOVER, FID and THEval and second on LSE-C. Judge your own avatar clip by pulling exact stills with Sume video frames.
TTS request timed out: retry with the same Idempotency-Key
If a Sume TTS request times out, do not post a fresh one. Retry with the same Idempotency-Key and body to get the original job back, with no second charge.
Which Sume audio endpoint do I need? TTS, STT, music, detach, split
Sume has separate endpoints for text to speech, speech to text, music, detaching video audio, and splitting or joining audio. Here is which to call for what.
Timeline invalid_segment_timing and segment_overlap: fix your starts
Sume timeline returns invalid_segment_timing or segment_overlap when video starts do not increase or slots overlap past the transition. Fix the start values.
Music-only short: Timeline silence, a soundtrack and no duck_db
A music-only short on Sume Timeline declares audio.mode silence and adds a soundtrack bed. duck_db needs a real voice spine, so leave it out.
Sume Format output_schema: strict false does not loosen the rules
Setting strict to false in a Sume Format output_schema does not relax the OpenAI-strict subset. Fix the schema instead. Responses-style text.format is refused.
Sume webhook retries last 270 to 370 seconds: when to poll
Sume tries a job webhook up to 10 times, 30 seconds apart, with a 10 second timeout each. That is about 4.5 to 6 minutes of retries before you must poll.
Abort a waitForJob wait with AbortSignal: the Sume job keeps running
Passing signal to waitForJob stops your wait and aborts the in-flight request. It does not cancel the job, which keeps running and billing. Keep the job id.
v0 MCP tool approval and Sume: ask first before paid calls
v0 lets you disable tools and set ask-for-approval or auto-use per MCP. Pair that with Sume's dry_run and max_spend_usd so a paid call never runs unreviewed.
Neon cyberpunk street at 1080p for 10 seconds: five Sume models
A 10-second 1080p cyberpunk street clip costs $1.40 to $2.50 on Kling 3, Omni Flash 1.1, H3 Max and Wan 3.0 on Sume; Seedance 2.5 is $14.22.
Image-to-image from a reference avatar: six poses on GPT Image 2.5
Turn one avatar or mascot image into six pose stills with input_references on GPT Image 2.5: $0.125 at medium, $0.50 at high. Request and checks on Sume.
GPT Image 2.5 with 16 references costs 5 times a text-only call
Each reference adds an estimated input-token charge on GPT Image 2.5 via Sume: 0 refs $0.0659, 1 ref $0.0835, 16 refs $0.347 at high 1024x1024.
Sume timeline with silent audio: audio.mode silence and its limits
Set audio.mode to silence in Sume Timeline 1.0 for a declared length with no spine file. Do not send url, parts, gain_db or source_in, and no ducking bed.
Sale intro card, then the clip: two timeline slots, not compose
A still card then a video is not a compose mode in Sume. Compose shows both at once; two adjacent timeline-1.0 video slots put the card first, then the clip.
Skipped Sume scheduled run: no webhook, read the create response
A skipped or canceled Sume run sends no webhook. For api-trigger, on_active_run=skip is the default, so check the create response, not just your webhook inbox.