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.
Image API provider.only and provider.order: which slug works?
Sume's image API takes provider.only and provider.order but lists one endpoint per model, slug sume. Which routing fields do anything, and the 400 for the rest.
Image generation API streaming: partial images on Sume
Sume's image API does not stream partial images yet: stream true returns 400 streaming_not_supported. Submit async, read events, or use a webhook.
image_not_fetchable error: what it means and how to fix it
image_not_fetchable means Sume could not fetch or mirror your input image. Check it is a public HTTPS image URL, then retry or send the request id to support.
Imagen 4 Ultra API on Sume: 1K and 2K, and the Fast id
Sume lists google/imagen-4-ultra with a resolution of 1K or 2K (default 2K) and google/imagen-4-fast with none. Both are text-only, with a flat price per image.
Instagram API is_ai_generated: label an AI Reel
Set is_ai_generated=true when you create the media container and Instagram's API records your AI self-disclosure. Carousels take it on the parent only.
Instagram trial Reels API: trial_params and graduation
Publish an Instagram trial Reel by API with trial_params.graduation_strategy set to MANUAL or SS_PERFORMANCE. Trial Reels reach non-followers only.
Lip sync longer than 15 seconds: split the audio first
MiniMax H3 Max lip sync on Sume takes 5 to 14.8 s of audio. For a longer line, use VEED Fabric up to 300 s, or split the audio into ranges and sync each piece.
MCP server rate limit: per tool call or per request on Sume?
On Sume the MCP endpoint POST is a read, a tool call spends write budget once for the run it creates, and a jobs_status poll over MCP spends no write budget.
MCP-Method header: route and rate-limit MCP requests at a gateway
The 2026-07-28 MCP spec requires Mcp-Method and Mcp-Name headers on HTTP requests. How Sume counts MCP calls against its rate limits.
MCP input_required, inputResponses and multi round trip vs dry_run
MCP 2026-07-28 lets a server return input_required and the client retry with inputResponses. Sume's paid confirmation is two calls with dry_run instead.
MCP OAuth resource indicator: is a token bound to the server?
Sume's MCP OAuth resource audience is https://mcp.sume.com/mcp, its authorization server is the MCP origin, and the token is not an API key.
MCP roots, sampling and logging deprecated: Sume impact
The 2026-07-28 MCP spec deprecates Roots, Sampling and Logging. Sume's hosted server declares only tools, so a client calling it has nothing to migrate.
MCP Tasks extension: does Sume use it for long jobs?
No. Sume's hosted MCP server has no task handles. A paid create returns a job id, and you poll it with jobs_status or jobs_wait, then read jobs_result.
MCP tools/list ttlMs and cacheScope: what is safe to cache?
The 2026-07-28 MCP spec adds ttlMs and cacheScope to tools/list. Sume's tool list depends on the session's scopes, which is why caching it per session matters.
Unsupported MCP protocol version: the 400 from Sume's server
Sume's MCP endpoint answers an MCP-Protocol-Version it does not support with HTTP 400 and code -32600. Here is what the 2026-07-28 spec tells a client to do.
MiniMax H3 4-second clips: MiniMax says 4, Sume says 5
MiniMax lists 4–15 seconds for H3, but Sume's docs and pricing code start at 5 seconds. Send 5 or more, and trim to 4 afterwards if you need it.
MiniMax H3 768p: why 720p is refused and what to send instead
MiniMax H3 renders natively at 768p, not 720p. Sume refuses resolution 720p on H3 and H3 Max and tells you to use 768p. The accepted values per id.
MiniMax H3 aspect ratios: 21:9 to 9:16, and when adaptive works
MiniMax H3 makes six aspect ratios, from 21:9 to 9:16. Which ones Sume accepts, where adaptive is allowed, and how frame images set the ratio.
MiniMax H3 in ComfyUI or through a hosted API: what differs
ComfyUI documents three MiniMax H3 workflows with local model files; a hosted API returns a job. The limits that change between the two, from the docs.
First and last frame to video with MiniMax H3: request and rules
MiniMax H3 fills the motion between an opening and a closing image. On Sume send frame_images with first_frame and last_frame; ratio, length and price rules.
Multi-shot AI video prompts: MiniMax H3 shot labels and timecodes
MiniMax H3 models multiple shots natively. Write [Shot 1] labels or timecoded blocks in the prompt; syntax from the vendor guides and a Sume request.
MiniMax H3 prompt guide: reference jobs, negative direction, length
The MiniMax H3 prompting rules that change output: give each reference a job, write timecodes, say what to avoid, and stay under 7,000 characters.
MiniMax H3 reference limits: 9 images, 3 videos, 3 audio, 12 total
The MiniMax H3 reference-to-video limits and the errors Sume returns when you cross them. Counts, clip lengths, the audio-only rule and image price.
Video to video motion transfer with AI: MiniMax H3 reference video
MiniMax H3 lists V2V motion transfer. Send a motion video and character images as references on Sume, write each reference's job, and mind the limits.
MiniMax H3 voice reference: match a voice with an audio clip
MiniMax H3 accepts up to 3 audio clips as references. How to write the prompt, the limits Sume enforces, and the rule that audio cannot be the only reference.
fal subscribe equivalent for a video API: Sume has no SSE
Sume accepts mode subscribe but it is an alias of sync: one 30-second wait, no event stream. For a fal-style long wait, submit async and poll status.
Music API waveform data: get peaks from the audio file yourself
ElevenLabs added optional waveform data to music generation. Sume's music result has no waveform field, so compute peaks from the audio artifact with ffmpeg.
n8n AI Agent: force tool call on first iteration with Sume
n8n 2.40 added Force Tool Call on First Iteration to AI Agent v3. If Sume MCP is the tool, the first call is real: what a session can reach and the gates.
n8n MCP custom headers with OAuth token refresh: Sume caution
n8n 2.40 keeps custom headers on MCP registry remotes through OAuth token refreshes. With Sume, do not add an API-key header on top of an OAuth bearer token.
Nano Banana 4K resolution API: the tier strings Sume accepts
Google says Nano Banana 2 spans 512px to 4K. On Sume you pick a tier with resolution: 512, 1K, 2K or 4K. The default, and why 4K can return 202.
OpenAI Agents API remote MCP server: what to give it for Sume
OpenAI's Agents API takes MCP servers at session setup. Give it Sume's mcp.sume.com/mcp URL and an API key, and gate paid calls with idempotency_key.
OpenAI Agents API webhooks: when the agent finishes, and Sume's
OpenAI says to stream output or use webhooks to learn when an agent finishes or needs input. Sume sends one agent.run.terminal webhook per run, never on cancel.
Restrict API key creation: what OpenAI added, and Sume's key rules
OpenAI added admin controls to restrict API key creation on 2026-09-15. Sume keys are workspace-scoped with fixed scopes and rotate by replacement.
Extract on-screen text from a reference video with an API
Reference ingest reads on-screen text at source resolution, returns lines with boxes, spans and confidence, and flags low-confidence lines instead of guessing.
Check whether a reference video is silent before adding music
Reference ingest reports audio.silent at a -60 LUFS gate, speech presence and beats, so you know whether to keep, replace or add a soundtrack before a remix.
Seedance 2.0 API errors: what each 400 and 404 means
A Seedance 2.0 request on Sume fails with 400 unsupported_parameter, 400 unsupported_capability or 404 model_not_found. What triggers each and the fix.
Seedance 2.0 aspect ratio auto: can you send it on Sume?
fal's Seedance 2.0 pages list aspect_ratio auto. Sume's seedance-2 advertises six fixed ratios and refuses others, so send 16:9, 9:16 or another listed value.
Seedance 2.0 reference limits: 9 images, 3 videos, 3 audio?
fal lists Seedance 2.0 reference-to-video at up to 9 images, 3 videos and 3 audio clips, 12 files in all. On Sume the API enforces the 12-file total. Details.
BytePlus ModelArk Seedance 2.5: limits, tasks and how Sume maps
What BytePlus's ModelArk tutorial documents for Seedance 2.5 (task types, drafts, rate limits, retention) and which concepts exist in Sume's video API.
Seedream 5.0 censorship: what a blocked image looks like on Sume
Sume's Seedream calls run with the provider safety checker on, with no switch for it. What a refused generation returns, whether it is billed, and what to do.
Speech to text Korean API: send language_code or auto-detect?
Sume STT 1.0 takes an optional language_code such as ko; omit it and the language is auto-detected. When to pin Korean, when to omit it, and how TTS differs.
Which field do I branch on in a Sume API error: code or next_action?
Branch on the HTTP status, then on error.code. Use retryable, retry_after_seconds and next_action to decide on a resend. Never match on message.
API sends both Authorization Bearer and x-api-key: 401
Sume rejects a request that carries both Authorization: Bearer and x-api-key with 401 and 'Send only one API key credential.' Neither header wins. Fix it.
Sume webhook retry schedule: 10 attempts, then what?
Sume tries a webhook up to 10 times. Job webhooks use a fixed 30 s gap; run webhooks back off with jitter up to an hour. What happens next, and how to replay.
Suno alternative with an API: what Sume's Music Router does
Looking for a music generator you can call from code? What Sume's Music Router takes in, returns and does not do, so you can decide if it fits.
Suno API: the music API options and what Sume offers
Looking for a Suno API? Sume does not list Suno, but the Music Router takes a prompt and returns audio. Request shape, async polling, limits and fixed price.
Suno old models retired, what now? Keep a music API stable
Vendors retire music models and Sume's Music 1.0 is retiring gradually too. Call the router, log job.model and routed_model, and pin ids so changes are visible.
API sync mode wait timeout: the job is still running, so poll
When a Sume sync request returns before the job ends, the job still runs. Read sync.timed_out and sync.capacity_exhausted, then poll status_url, not a resubmit.