Guides
Sume guides: the API, Formats, agents, models, media tools and pricing, each answer dated and sourced.
Hotel room tour clip from 10 photos with Omni Flash 1.1
Gemini Omni Flash 1.1 on Sume takes up to 10 reference images and 3 short clips. An 8-second room tour costs $1.00 at 720p, $1.50 at 1080p and $3.00 at 4K.
Sume MCP OAuth: the consent page is on mcp.sume.com, not app
A Sume MCP client OAuth flow goes /oauth/authorize then /oauth/consent on the MCP host. Do not send users to app.sume.com; here is what the flow checks.
Free-returns ribbon across the top of a clip: compose overlay
Put a free-returns ribbon at the top of a holiday product clip with Sume timeline compose overlay: position top, width_ratio, margin_ratio, $0.02 a job.
waitForJob onStatus also fires on the terminal poll: Sume SDK
In @sume-com/sdk, onStatus runs on every status read, including the last one. Use it for progress and take the result from the job waitForJob returns.
12-minute interview: two STT jobs, detach ranges 0-600 and 600-720
Sume STT takes up to 10 minutes per job. Detach a 12-minute interview in two ranges, 0 to 600 and 600 to 720 seconds, and transcribe both for about 14 cents.
Burn in captions from your own word timings with Sume (no STT)
Send words or cues to Sume video captions and it burns your text at your times with no speech-to-text. Send only one text input per request.
One script, three lengths: 60, 180 and 600 s billed at 10, 30, 100c
A 60-second Reel, a 180-second Short and a 600-second TikTok each fit their platform's page. Sume Timeline bills them at $0.10, $0.30 and $1.00.
Sume job.canceled and job.failed webhooks both say status ERROR
A Sume job.failed and a job.canceled webhook both carry status ERROR and an error object. Branch on the event name, not on status, to tell them apart.
Dog photo to a 5-second clip with sound: six Sume models
Animate one dog photo for 5 seconds at 720p. Six Sume video ids priced side by side, from $0.38 to $2.89, and which of them cannot turn the sound off.
Which JSON Schema keywords a Sume Format output_schema accepts
Sume Format schemas use an allowlist: unknown keywords fail with unsupported_keyword. Number bounds are allowed; oneOf and allOf are not. Table inside.
VHS camcorder look on purpose: 360p and 480p AI video on Sume
A 6-second 360p or 480p AI video costs $0.23 to $0.53 on Sume. Omni Flash 1.1 is the only video id with a 360p rung; the others start at 480p.
Video frames fps on Sume: mid-bin sampling and the 24-frame cap
Sume video frames with fps 0.5 samples at 1 s, 3 s, 5 s and so on, capped at 24 frames per call, at source size. Use at[] for exact instants.
Use the idempotency_key on Sume job objects as your join label
Every Sume job object returns the idempotency_key it was created with, and list order is newest first. Join your own labels on that key, not on array position.
Cost of 100 four-second AI clips: Magnific credits vs Sume wallet
One hundred 4-second clips cost $52.80 to $176 in Magnific credits and $100 to $231 on Sume, by model. Seedance 2.5 uses 73% of a Premium year of credits.
Farmers market square 1:1 clip: which Sume models take it
Omni Flash 1.1 is 16:9 or 9:16 only, so a square feed clip needs Wan 3.0, Kling 3, H3 or Seedance. Six-second 720p prices from $0.45 to $3.47.
Gemini Omni Flash 1.1 reference-to-video: IMAGE_REF tags
Use up to 10 reference images and 3 short reference videos in one Gemini Omni Flash 1.1 request on Sume, and point at them with <IMAGE_REF_0> and <VIDEO_REF_0>.
Edit an existing video with Gemini Omni Flash 1.1 over an API
Send video_url and an instruction to gemini-omni-flash-1.1 on Sume to edit a clip: no duration or aspect ratio, resolution optional, native audio on.
Sume 413 payload_too_large and 415: shrink the body, send JSON
413 means the request body is over the API limit. 415 means the body was not application/json, shown in details.received_content_type.
Sume 400 invalid_request: read the details array
A Sume 400 invalid_request means the body, query, path or headers are not valid. The error envelope has code, message, request_id and a details array.
Sume webhooks: return 2xx only after you store the event
Store the event durably, then return any 2xx. Sume retries non-2xx and network errors. Use job_id as your idempotency key to absorb duplicates.
Sume webhook replay protection: reject timestamps over 5 minutes old
Reject Sume webhook callbacks whose timestamp is outside your tolerance window. The docs suggest five minutes. Redeliveries carry a fresh timestamp.
Sume 409 errors: job_not_completed, job_not_cancelable and more
A Sume 409 means the job operation does not fit the job's current status: job_not_completed, job_not_cancelable or job_generation_already_started.
Sume webhook Send test vs Redeliver: they are not the same
Send test posts a dummy signed webhook.test payload to a URL you type. Redeliver re-sends a real job's terminal event. Pick the right one for the job.
Sume job statuses: queued, processing, completed, failed, canceled
The five Sume job statuses and what a client should do at each. Resources use a different set: processing, ready, failed, canceled and archived.
Sume has two 429s: rate_limited and queue_full, handled differently
rate_limited is a request window. queue_full means workspace concurrency and queue capacity are both full; wait for a job to finish or cancel one.
Sume job webhook events: job.completed, job.failed, job.canceled
Sume sends only terminal job events: job.completed, job.failed and job.canceled. No progress events. Failed and canceled payloads carry status ERROR.
Sume job error categories and the next action for each
Failed Sume jobs carry a category: validation, auth, quota, queue, generation_unavailable, generation_rejected, timeouts, runtime_unavailable or internal.
Sume webhook signature will not verify: compare the fingerprint
Each Sume delivery has x-sume-webhook-secret-fingerprint. Compare it with the dashboard fingerprint to find a wrong secret without ever sending the secret.
Gemini Omni Flash 1.1 generate_audio false: why the API refuses
gemini-omni-flash-1.1 on Sume always makes native synced audio, so generate_audio: false is rejected. Replace the sound in a Timeline instead.
Sume webhook_url must be public HTTPS: localhost and http are rejected
Sume rejects localhost, private-network and non-HTTPS webhook URLs. Test local receivers through a public HTTPS tunnel or poll the job instead.
Sume request id: what to share with support and what to leave out
Every Sume error body and header carries a request id that is safe to share. Do not include API keys, signed URLs, raw media URLs or private workspace ids.
Sume image_not_fetchable: make the input a public HTTPS image URL
image_not_fetchable and input_media_unreachable mean Sume could not fetch or mirror your media safely. Use a public HTTPS URL and retry.
Sume 429 rate_limited: honor retry-after and use an Idempotency-Key
On a Sume 429 rate_limited, back off using retry-after if present, and never retry an unsafe submit without an Idempotency-Key. Headers explained.
Verify a Sume webhook in Node: raw body, timing-safe compare
A short Node verifier for Sume webhooks: sign timestamp.rawBody with HMAC SHA-256, compare sume-v1 entries with timingSafeEqual, and refuse an empty secret.
Sume 402 insufficient_credits: top up, then retry the same request
A Sume 402 means the balance cannot cover the requested generation. Add funds or lower the request cost, then retry with the same Idempotency-Key.
Sume webhook secret rotation: why the header has two sume-v1 entries
During a signing-secret rotation Sume sends one sume-v1 entry per live secret, newest first, comma separated. Accept the delivery if any entry matches.
Sume 503 provider_capacity_exceeded: retry later, same key
provider_capacity_exceeded means Sume's provider dispatch queue is full. Retry later with the same Idempotency-Key. provider_not_configured is different.
Sume webhook vs async polling vs sync vs subscribe: pick a mode
Sume has four communication modes: async, sync, webhook and subscribe. Webhook is best for servers, but keep the poll fallback for lost deliveries.
Sume 401 and 404: wrong API key, or a resource in another workspace
401 unauthorized means the API key is missing or invalid. 404 not_found means the resource does not exist in the current workspace, so check which key you used.
Add one real shot: how a filmed clip changes an AI Short
One filmed shot of your own among generated clips gives an AI Short a part nobody else has. What YouTube's pages say, the label question, and a Timeline build.
How many cuts in a 30-second Short? Timeline's 12 and 8 limits
More cuts do not make a Short original, but Sume Timeline has hard limits: 200 slots, chunking past 12 segments, 8 chained fades. What they mean for pacing.
Is running the same Format weekly a template to YouTube?
A Sume Format is a saved recipe, not a saved video. How to separate the repeatable process from the repeatable output so weekly Shorts do not read as templated.
Minor technical edits vs real edits on YouTube Shorts
YouTube told creators to bring a voice, not minor technical or template changes. What that means for crops, filters and speed tweaks, and what real edits add.
One Short in Korean and English: caption styles and rules
Posting a Korean and an English cut of your own AI Short? YouTube is silent on translations; Sume caption styles are not. Which style fits which script.
Six Short structures to rotate so no two feel the same
Original is not only the topic. Six repeatable structures for 15 to 60 second Shorts, with slot counts and a rotation plan for Sume Timeline builds.
Blog post to a 45-second Short that is not the article aloud
Reading an article over stock clips is the pattern YouTube warns about. Pull one claim, add your own angle, and build the Short with Sume Timeline.
First-frame stills for 500 SKUs: five image models priced
Generating 500 product first frames costs $32.95 on gpt-image-2.5 high, up to $131.95 on gpt-image-2. A per-model price grid from Sume prices, read 2026-10-05.
Five product photos to one 15-second ad: five clips and a Timeline
Animate five angles of one product with Wan 3.0 at $0.625 each, cut 3 s from each in a $0.10 Timeline render, add $0.20 captions: $3.43 for a 15 s vertical ad.