Guides
Sume guides: the API, Formats, agents, models, media tools and pricing, each answer dated and sourced.
Batch image generation API: how many images can run at once?
Sume queues extra generation jobs instead of rejecting them. The per-plan concurrency and queue table, the 429 queue_full case, and how to size an image batch.
Boost an Instagram Reel with the Meta ads MCP server
Meta's ads MCP server lists boost-eligible Instagram media with ads_get_ig_media and boosts one with ads_boost_ig_post. New ads start paused.
AI dubbing API: build the pipeline from STT, TTS and audio joins
Sume has no one-call dubbing route. Chain audio detach, STT 1.0, your translation, TTS 1.0 and Timeline audio into a dub. Routes, limits and the $0.01 steps.
Call n8n Workflow Tool not working: video sub-workflow
If an n8n agent says it couldn't run your sub-workflow, publish it: the tool returns 'Workflow is not active' outside the test panel. More checks inside.
Can AI make an App Store preview video? Apple's rules
Apple says an app preview uses footage captured on device and shows only content inside the app. A generated clip can't be it, but can be your promo.
Can Notion send webhooks? Start an AI video job from a page
Yes: Notion's Send webhook action posts page properties to your URL, and integration webhooks report changes. Call Sume from your own endpoint.
Can you use an AI voice on TikTok Shop?
In posted videos, yes: TikTok Shop's 09/02/2026 policy allows AI dubbing and narration. In a LIVE, AI-generated voices are prohibited.
Cartesia Sonic 3.6 API: which model id to send
Send sonic-3.6 for the latest stable Sonic 3.6, a dated id to freeze it, or sonic-preview for beta. Which of these ids Sume's TTS Router lists.
Change one lyric in an AI song without regenerating it
Suno says v6 can update a single lyric in an existing song. Sume's music docs list generation only, so a changed lyric means a new track.
AI thumbnail that matches my channel style: the reference method
YouTube lists channel-matched thumbnail generation as coming. To match your style now, pass your best thumbnails as references and reuse one style paragraph.
ChatGPT image storyboard: make frames with GPT Image 2.5
Make a storyboard with GPT Image 2.5 by API: one call per frame, the same reference images each time, and a prompt that names what stays fixed.
ChatGPT image style transfer: restyle a photo by API
For style transfer with ChatGPT Image 2.5 by API, send the photo as an input reference and name the new style in the prompt. The request and its limits.
ChatGPT Images 2.5 vs GPT-Image-2.5: which name is the API?
ChatGPT Images 2.5 is OpenAI's product; GPT-Image-2.5 Flare and Sunburst are the API models. How the names map to Sume ids and which features stay in ChatGPT.
ChatGPT Images flyer template: a fill-in prompt for the API
Sume has no flyer template field. Build one as a fill-in prompt with exact text slots, a portrait image_size and a higher quality tier, then check every word.
ChatGPT Images shared prompt: reuse it on your own photos via API
A shared image prompt is only text. Save it in a file, then run it over your own photos with input_references on Sume and match each result to its source.
ChatGPT Images templates (Poster, Merch): are they in the API?
ChatGPT Images 2.5 templates like Poster and Merch are a ChatGPT feature. Sume's image API has no template field, so write the brief as a prompt.
Does ChatGPT Images 2.5 add a watermark? C2PA explained
OpenAI says ChatGPT Images 2.5 uses C2PA metadata and invisible watermarking to identify its images. What that means for files you get through an API.
ChatGPT plugins vs MCP server: where does Sume fit?
A plugin is a package that can carry an MCP server. Sume is the server. Here is how the two relate in ChatGPT and Codex, and what a Sume connection still needs.
Claude Code permissions ask rule for paid MCP tools
An ask rule in Claude Code settings prompts every time a named MCP tool runs, even if an allow rule matches. Rules for Sume's paid tools and their limits.
claude -p with --mcp-config: run Sume video tools from a script
Use claude --bare -p with --mcp-config and --allowedTools to call Sume's hosted MCP tools in CI; read mcp_server_errors so an unloaded server fails the job.
Claude Code hooks not firing on an MCP tool: 6 causes
A PreToolUse hook that never fires on an MCP tool usually has a matcher problem: a bare server name, a plugin's scoped name, or a missing .*. Fixes for Sume.
Claude Code managed-mcp.json exclusive: allow the Sume server
An exclusive managed-mcp.json fixes the MCP servers Claude Code may use. What to put in it for Sume's hosted server, and what Claude Code 2.1.282 added.
Claude Code --callback-port: do you need it for Sume MCP?
No. --callback-port is for servers that need a pre-registered redirect URI. Sume registers clients dynamically, so Claude Code's default random port works.
Claude Code headersHelper: read the Sume API key at connect
Claude Code's headersHelper runs a command at connect time and merges its JSON into the request headers. Use it to send a Sume API key from a secret store.
Claude Code MCP progress notifications on a background call: Sume
Claude Code 2.1.283 fixed MCP progress notifications dropped on background calls. Sume's docs describe bounded jobs_wait slices instead of a progress stream.
Claude Code /mcp reconnect all: what it does for a Sume MCP server
Claude Code v2.1.284 added /mcp reconnect all. Because Sume's hosted MCP server keeps no session, a reconnect needs no state recovery; job ids carry the work.
Claude Code mcp_tool hook on PreToolUse for a spend check
Claude Code 2.1.282 makes mcp_tool hooks on blocking events wait for their MCP server. With Sume, the check to run there is a dry_run cost preview.
Claude Code MCP tool timeout: what to set for slow jobs
Claude Code lets you set a per-server timeout in ms. Sume's jobs_wait returns within 55 seconds, so a slow video job needs no long timeout.
Claude Code "No such tool available" on a resumed MCP session
After resuming a Claude Code session, a first MCP call could fail with No such tool available. Claude Code 2.1.284 waits up to 10 seconds. The Sume side.
OTEL_LOG_TOOL_CONTENT with MCP tool output: what Sume logs could leak
Claude Code 2.1.283 can put MCP tool output on an OTEL span when OTEL_LOG_TOOL_CONTENT=1. With Sume, check that output for signed URLs and keys first.
Claude Code plugin .mcp.json: bundle a Sume MCP server
Put Sume's hosted MCP server in a Claude Code plugin's .mcp.json, prompt each teammate for their own API key, and install it from a team marketplace.
Claude Code PreToolUse hook example: gate paid Sume tools
A PreToolUse hook that lets dry_run previews through, denies paid Sume MCP calls with no max_spend_usd, and asks you before the rest. Script and settings.
Claude Code MCP server connected twice: duplicate connector fix
Claude Code 2.1.281 stopped connecting one MCP server twice when a plugin or connector spells its URL differently. What it means for Sume's single MCP URL.
Claude Code subagent MCP server: scope Sume tools to one
Put a Sume MCP server in one subagent's mcpServers field so video and image tools stay out of the main chat. Frontmatter for both routes, plus limits.
MCP URL mode elicitation in Claude Code vs OAuth consent
Claude Code 2.1.281 added MCP URL-mode elicitation, a browser flow a server can request. Sume's browser step is OAuth consent, a different mechanism.
claude mcp login over SSH: sign in to Sume with no browser
On a machine with no browser, claude mcp login prints the sign-in URL. Open it on your laptop, then paste the redirect URL back. Sume's MCP works this way.
claude mcp logout: how to sign out of a remote MCP server
Run claude mcp logout <name> or pick Clear authentication in /mcp to remove stored credentials. What that does for Sume's hosted MCP, and the hourly token.
Claude Opus 5.5 and paid MCP tools: preview and cap spend with dry_run
Give Claude Opus 5.5 a paid video tool without a surprise bill: dry_run previews cost, max_spend_usd caps a call, idempotency_key stops double submits.
Claude skill allowed-tools: pre-approve Sume MCP tools
A skill's allowed-tools field pre-approves tools for one turn and does not restrict the rest. How to list Sume's job tools and leave paid ones prompting.
Claude Sonnet 5.5 MCP tools in Claude Code: add Sume video/image tools
Claude Code v2.1.284 made Sonnet 5.5 the default Sonnet. Add Sume's hosted MCP server in two commands and give that model video and image generation tools.
Batched tool calls and video jobs: one jobs_wait for up to 20 clips
Anthropic says Claude Sonnet 5.5 batches tool calls more than Sonnet 5. On Sume MCP, submit several clips in parallel, then wait on all with one jobs_wait.
Claude Sonnet 5.5 or Opus 5.5 for an agent that calls a video tool?
Sonnet 5.5 and Opus 5.5 differ in price and release date on Anthropic's pages. Which facts matter when the tool is Sume's video generation, and what stays same?
Claude tool_result is_error: return Sume API errors
When a Sume REST call fails inside your Claude tool loop, send the error back as a tool_result with is_error true and say what to try next. Code and table.
Codex bearer_token_env_var: connect Sume MCP with an API key, no OAuth
Set url and bearer_token_env_var in Codex's config.toml so a Sume API key from the environment authenticates hosted MCP, with enabled_tools to shorten the list.
Codex MCP OAuth client registration: CIMD or DCR for Sume
Codex registers with Sume's hosted MCP server by Dynamic Client Registration, because Sume's metadata advertises no Client ID Metadata Document support.
Codex mcp-server command removed: does Sume still work?
Codex removed `codex mcp-server` on 2026-09-05. Connecting Codex to Sume's hosted MCP server uses `codex mcp`, which the changelog says continues.
How to combine audio files without gaps using an API
Join audio files into one gapless file with Sume's Timeline audio concat: up to 20 parts, sample-domain, with segment offsets returned for re-basing.
CrewAI ToolFailure: report a paid API error
Return a ToolFailure from a CrewAI tool when Sume refuses a job, so the run records a failure instead of a success, and set the policy to raise.