Developers
Building on the Sume API: keys and hosts, jobs and runs, polling, webhooks, idempotency, errors and rate limits, the SDK, the CLI, and MCP auth.
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 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_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 "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 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 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 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.
Cursor agent subscriptions and scheduled runs calling an API
A Cursor scheduled run can call Sume's HTTP API to start a saved schedule run. The three prerequisites, the request, and why a skipped run still returns 200.
Cursor Projects subagents and MCP tools: capping Sume spend
Cursor Projects lets a coordinator delegate to subagents. If they share a Sume MCP connection, spend gates sit on each call: idempotency keys, dry runs, caps.
Cursor self-hosted machines: where a Sume API key can live
Cursor's self-hosted machines run agents on hosts you pick. Sume's key rule is short: trusted servers, CI secret stores or your own machine, never chat.
Low latency text to speech API: 150 ms streaming vs async jobs
ElevenLabs quotes about 150 ms to first speech for Eleven v4 Turbo. Sume's text to speech returns a finished file per job, so pre-render lines you can predict.
ElevenLabs API alternative: what to check before switching TTS
Thinking of moving text to speech off ElevenLabs? Sume's TTS is an async job API with Sonic ids on a router. The contract points to check before you switch.
ElevenLabs Dubbing v2 API: what it does, and what Sume offers
ElevenLabs Dubbing v2 is a project-based API with editable transcripts. Sume has no dubbing route; here is how its STT, TTS and audio-join steps map on.
ElevenLabs music API: composition plans vs a prompt-only API
ElevenLabs added Music v2.5 API support on 2026-09-14 with composition plans. How a plan differs from Sume's prompt-only music route with no duration field
Enterprise API rate limit: what a Sume key gets by default
Sume's Enterprise rate limit is contracted, not self-serve. Until a number is provisioned, an Enterprise key gets the Scale row, plus 20 concurrent jobs.
Retry a failed run: same idempotency key returns old failure
Retry a failed run: the same Sume Idempotency-Key returns the old failure. Use a new key, or continue with previous_run_id to keep finished clips.
fal bytedance/seedance-2.0 request fields, mapped to Sume's
Moving a fal Seedance 2.0 call to Sume: the path becomes a bare model id, image_urls become input_references, and seed, auto ratio and auto duration go.
FLUX.2 multi-reference editing API: how many images can I send?
FLUX.2 edits from several reference images. Black Forest Labs' API takes up to 8; Sume's flux.2-pro catalog row lists up to 10 input_references.
FLUX agent skills for video direction, and Sume's skill install
BFL released six Agent Skills for FLUX 3 video direction on 2026-08-07. Sume ships its own skill through the CLI. Where each installs and what it cannot do.
FLUX MCP server generate_video: what Sume's hosted MCP has
BFL's FLUX MCP server gained generate_video and enhance_video on 2026-08-11. Sume's hosted MCP has its own generate_video and video_upscale_create tools.
Video judder with mixed frame rates: Timeline's warning
Judder on a joined video comes from resampled frame rates. Sume's Timeline warns output_fps_resamples_sources when a source rate differs. How to read it.
Gemini CLI MCP OAuth metadata discovery blocked: Sume check
Gemini CLI v0.59.0 added SSRF prevention to MCP OAuth metadata discovery. Sume publishes metadata at two public HTTPS URLs; how to confirm both from a shell.
Gemini CLI MCP servers not loading in an untrusted workspace
Gemini CLI v0.59.0 filters mcpServers in restricted mode. If Sume is missing in an untrusted folder, trust is the cause; then tell it from an OAuth issue.
GPT-6 Astra tool calling needs the Responses API: meaning for Sume
OpenAI says GPT-6 Astra supports Chat Completions but its tool calling requires Responses. Use the Responses mcp tool for Sume, not a chat.completions loop.
How long does GPT Image 2.5 take? Time your own jobs on Sume
Sume publishes no per-model image time for GPT Image 2.5, only a 30-second wait budget. A short curl script times your own prompts by quality and size.
GPT Image 2.5 arena: run your own blind test through the API
Arena leaderboards rank images on other people's prompts. Here is a blind three-way test of Flare, Sunburst and GPT Image 2 on yours, with one script on Sume.
GPT Image 2.5 background: transparent vs opaque in the API
Sume accepts background auto, transparent or opaque on the two GPT Image 2.5 ids only. What opaque does, what a bad value returns, and which models reject it.
GPT Image 2.5 SVG output: why the API rejects svg
GPT Image 2.5 on Sume advertises png, jpeg and webp. Asking for svg returns a 400 that lists the accepted formats. How to check and what to do for vector art.
GPT Image 2 vs GPT Image 2.5: what changes when you migrate
GPT Image 2 stays selectable on Sume. Moving to 2.5 means a new model id and new limits: six quality values, 16 references, mask_url. Old requests keep working.
GPT Image 2.5 image editing API: edit a photo with a prompt
Edit a photo with GPT Image 2.5 on Sume: send the image in input_references, describe the change, and set aspect_ratio to auto. Up to 16 references per call.
GPT Image mask edit API: how to use mask_url on GPT Image 2.5
GPT Image 2.5 on Sume takes an optional mask_url for edits. OpenAI says the mask needs an alpha channel and only guides the edit. The request and the limits.
GPT Image 2.5 multi-round edits: chain edits on one image via API
To make several edits to one picture with GPT Image 2.5, feed each result back as a reference. What fal says Sunburst preserves, and what to check each round.
GPT Image 2.5: how many images can I generate per request?
On Sume, GPT Image 2.5 takes n from 1 to 4 images per request, billed per image. How to ask for several versions and what a 202 means for a larger n.
GPT Image 2.5 output format: png, jpeg or webp on Sume
GPT Image 2.5 on Sume returns png, jpeg or webp through output_format. Which to pick for transparency and speed, and what output_compression does on Sume today.
GPT Image 2.5 reference images: how many you can send and how to use
GPT Image 2.5 on Sume accepts up to 16 reference images per request, six more than GPT Image 2. How to label each image's job in the prompt and what to check.
GPT Image 2.5 image URL expired? Save the file in Node
Sume returns GPT Image 2.5 results as signed URLs, not base64, and its docs give no lifetime. Download each file when the call returns. Node example.
GPT Image 2.5 transparent background: how to request a cutout by API
GPT Image 2.5 on Sume accepts background transparent. OpenAI says transparency needs png or webp output. The request, the catch, and when to use another route.
GPT Image 2.5 400 unsupported_parameter: fields each model accepts
A 400 unsupported_parameter from Sume's image API means the model does not list that field. Which GPT Image ids accept quality, mask_url and background.
Grok 4.7 remote MCP tool: connect Sume to the xAI Responses API
xAI's remote MCP tool works with grok-4.7 on the Responses API. Point server_url at Sume's hosted MCP, restrict allowed_tools, and cap spend on the Sume side.
Idempotency key replay returns the original response: read the flag
Replaying an Idempotency-Key on a Sume run create returns the original receipt with idempotency_hit true. How to spot a replay, and what a new body does.
Ideogram character reference API: what Sume passes through
Ideogram's API has character reference. Sume lists ideogram/ideogram-v3 with input_references, low, medium, high quality; no character reference is documented.
Ideogram V3 Turbo, Balanced, Quality: how Sume maps them
On Sume the quality field takes low, medium or high for Ideogram V3, and those map to TURBO, BALANCED and QUALITY. Omit it and BALANCED runs. Price is flat.