Guides
Sume guides: the API, Formats, agents, models, media tools and pricing, each answer dated and sourced.
Seedance asset:// ids vs Sume reference URLs
BytePlus Seedance takes asset://<asset ID> for preset digital characters and authorized assets. A Sume request takes image_url objects with HTTPS URLs instead.
Seedance real-face reference images rejected: what to do
BytePlus says Seedance 2.5 and 2.0 do not accept reference images or videos with real human faces. The exceptions, and a safe reference plan on Sume.
Seedance video URL: 24 hours, 100 downloads, and Sume artifacts
BytePlus keeps a Seedance 2.5 video URL for 24 hours, at most 100 downloads. What that means, and how to read and save a Sume job's hosted video artifact.
Sepia or blue tint filter for video by API
Tint a clip sepia or blue with colorchannelmixer, colorbalance or monochrome in Sume's video filter. Presets and .cube LUT files are not available.
Shared credits per seat vs one Sume workspace balance and keys
Runway Team adds 6,900 credits per seat to a shared pool. Sume uses one workspace USD balance and workspace-scoped API keys; concurrency follows the plan.
Sharpen video after an upscale: unsharp or cas filter API
Sharpen an upscaled clip with the unsharp or cas filter in Sume's video filter: one MP4 in, one new MP4 out, a flat per-job rate, and a free check first.
Shopify events: event-id header gone, dedupe on Sume job_id
Shopify events no longer send shopify-event-id. On the Sume side, dedupe job webhooks on job_id and send an Idempotency-Key on every paid submit that may retry.
Shopify product.variants.* trigger: one Sume image per variant
A product.variants.* Shopify events trigger can fire many times at once. Fan each event out to one Sume image job, and queue bursts on your side.
Split screen from one video by API: split and hstack
Put a clip beside its own filtered copy with split and hstack in Sume's video filter. One source in, one side-by-side MP4 out. Video filter takes only one clip.
Slack incoming webhook 1/sec: when 100 Sume jobs finish together
Slack incoming webhooks allow about 1 message per second. When 100 Sume jobs finish at once, store each webhook, then post to Slack from a paced queue.
Spotify AI credits in Song Credits: DDEX disclosure for AI music
Spotify shows AI credits in Song Credits only when your label or distributor submits the DDEX disclosure. No credit does not mean no AI. Keep job notes.
Stop-motion look at 12 fps: use the video filter fps filter
Timeline output.fps stops at 24, 25, 30 or 60. To get a choppy 12 fps look, run the fps filter in Sume's video filter and get a new MP4 for $0.02.
Suno v6 change one lyric: what Sume Music does instead
Suno v6 can swap one lyric or line and keep the rest. Sume Music is brief-driven and documents no lyric editing, so you edit the brief and generate a new track.
Supabase Edge Function 400 s wall clock vs a Sume video job
Supabase Edge Functions cap wall clock at 150 s on Free and 400 s on Paid. Do not wait on a video: submit in one function and receive the webhook in another.
Supabase Edge Function secrets: 100 per project, 2 for Sume
Supabase allows 100 secrets per project. A Sume webhook receiver needs two: your API key and the webhook signing secret. Names, rules and what to verify.
sync-3 lip sync takes 10-15 min: async job and webhook pattern
Sync lists sync-3 at about 10-15 minutes for a 30 s video. Do not hold a request open: submit async, take a terminal webhook, and keep polling as a backup.
Sync dubbing in 92 languages vs building a dub on Sume
Sync's built-in dubbing now lists 92 languages with speaker detection. Sume has no dubbing endpoint: chain transcription with a language hint, translation, TTS.
Sync free trial limits vs how Sume surfaces lip sync cost
Sync's free trial gives 3 lip sync generations a month, 20 seconds each. Sume lists no trial cap here: paid jobs need funds, and dry_run previews cost first.
Sync lip sync output: H.264 crf 17, HDR to SDR, alpha removed
Sync re-encodes lip sync output to H.264 at crf 17, turns HDR into SDR and drops alpha. Here is that next to what Sume returns for avatar video.
Sync react-1 model_mode and emotion vs Sume TTS emotion and speed
Sync react-1 edits an existing video with model_mode lips, face or head plus an emotion prompt. On Sume, emotion and speed are set in the TTS audio request.
Sync sync_mode bounce, cut_off, silence, remap vs Sume lengths
Sync offers bounce, cut_off, silence and remap when audio and video lengths differ. Sume has no such option: trim or split audio to the accepted window.
Synthesia dubbing file size limit: 5 GB or 2.5 hours
Synthesia dubbing accepts uploads up to 5 GB or 2.5 hours, 4K, in .mp4, .webm or .mov. Sume's limits sit at the audio stage: a 10 MB audio_url and 300 s.
Synthesia rejected status: moderation, error, and your handler
Synthesia marks a moderated video rejected, separate from error. Sume reports content_policy_rejected as a public_reason; an unfunded run is a 402 instead.
Synthesia video.completed webhook: the download URL is time-limited
Synthesia sends video.completed and video.failed, and its download URL is time-limited. Sume sends job.completed, job.failed and job.canceled with durable URLs.
Take It Down Act 48-hour removal for AI video apps and URLs
The FTC enforces a 48-hour removal duty on covered platforms. If your AI video app serves generated MP4s from durable public URLs, here is what to plan for.
Per-task cost in the API response: Runway vs Sume usage.cost
Runway task responses carry a credit cost, estimated while running and final on completion. On Sume, read usage.cost on the job, a USD billable amount.
Telegram Bot API 10.3 ephemeral sendVideo with a Sume clip
Bot API 10.3 adds ephemeral_message_parameters to sendVideo. Send a finished Sume artifact URL from your webhook handler; steps, retries and limits.
Threads API: wait about 30 seconds before publishing a container
Threads suggests waiting on average 30 seconds after creating a media container before threads_publish. Poll the container status, like a Sume job poll.
TikTok brand_organic_toggle vs brand_content_toggle on AI video
Set brand_organic_toggle for your own business, brand_content_toggle for a paid partnership, and is_aigc for AI video. How to carry the flags with each clip.
TikTok rate_limit_exceeded: 6 requests a minute per access_token
TikTok Direct Post allows 6 requests a minute per user access_token and returns 429 rate_limit_exceeded past it. Space publishes; Sume limits only generation.
TikTok spam_risk_too_many_posts vs reached_active_user_cap
Two daily TikTok 403s: spam_risk_too_many_posts is the per-user API post cap, reached_active_user_cap is your client quota. Hold videos till tomorrow.
TikTok unaudited_client_can_only_post_to_private_accounts
TikTok returns a 403 when an unaudited client posts to a non-private account. Test with private posts until the audit passes; Sume only supplies the file.
TikTok url_ownership_unverified with a media.sume.com URL
PULL_FROM_URL needs a TikTok-verified domain or prefix, so a media.sume.com URL fails with 403. Upload the bytes with FILE_UPLOAD or host a copy on your domain.
TikTok invisible watermark on reupload: what it covers
TikTok is testing invisible watermarks on AI Editor Pro content and on uploads with C2PA Content Credentials, since labels can vanish on reupload or edit.
TikTok PULL_FROM_URL times out after one hour: keep the URL live
TikTok pulls a PULL_FROM_URL file at up to 100 Mbps and times out one hour after it starts. The URL must stay live; a Sume durable URL has no expiry.
Fix tilted video perspective by API with the perspective filter
Sume's video filter allowlists ffmpeg's perspective filter, so you can pull a keystoned phone clip back to a rectangle. You choose the four corner points.
Tumblr video pixelated? Upload 720p H.264 MP4, not a 360p source
Tumblr re-compresses every upload and aims for 720p H.264 MP4. Ask for 720p when you generate, avoid 360p, and trim with exact mode to limit extra passes.
Tumblr video limits: 20 a day, 10 minutes each, 60 minutes, 500 MB
Tumblr allows 20 videos a day, 10 minutes and 500 MB per video, 60 minutes in total. How to size AI video batches, trims and clip lengths to fit.
Veo 3.1 latency is 11 seconds to 6 minutes: set your poll to match
Google lists Veo 3.1 request latency from 11 seconds to 6 minutes at peak. Poll with a deadline over 6 minutes; Sume's video docs poll every 30 seconds.
Veo 3.1 videos are stored 2 days: download them, and what Sume does
Google says Veo videos are stored for 2 days, and referencing one for extension resets the timer. Save the file early; Sume jobs return Sume-hosted artifacts.
VS Code 1.138 Codex and MCP tools: one Sume server entry
VS Code 1.138 lets Codex use VS Code's built-in, extension and MCP tools. Add Sume as one remote MCP server at mcp.sume.com and verify with tools_list.
wan2.2-animate-move vs animate-mix, and Sume's motion transfer
animate-move drives a still character with a reference video; animate-mix swaps a character into a video. Sume's Genjutsu row covers the move-style case.
wan2.7-videoedit camera replication vs Sume's video_url edit
Alibaba names wan2.7-videoedit for effect and camera-movement replication. On Sume, video edit is the video_url field on the Gemini Omni Flash 1.1 id.
Wan 3.0 at 30 fps, HappyHorse at 24: set Timeline output.fps
Alibaba lists Wan 3.0 at 30 fps and HappyHorse 1.1 at 24 fps. Joined in Sume's Timeline, a differing output.fps resamples sources and warns; omit it to match.
X animated GIF limit: 15 MB, 350 frames, and the MP4 alternative
X allows an animated GIF up to 15 MB and recommends 1280x1080 and 350 frames or fewer. Sume makes MP4 video, not GIF, so attach a short MP4 instead.
X API 403 "not allowed to post a video longer than N minutes"
The 403 means the clip exceeds the posting account's cap: 20 minutes by default, 125 for Premium or verified. Cut the video to that cap before you post.
X API paid_partnership true: disclose a sponsored AI video Post
Set paid_partnership true in POST /2/tweets to label a Post as paid promotion on X. Sume returns the video file; your own call creates and flags the Post.
X API media upload: initialize, append, finalize a Sume video
X's chunked upload now uses POST /2/media/upload/initialize, append and finalize. Download the finished Sume video, then run the three calls yourself.