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.
FLUX 3 Image 4K can take minutes: poll, and the Sume 30 s wait
FLUX 3 Image at resolution 4k can take several minutes, so poll. Sume blocks up to 30 seconds, then returns 202 with a job envelope to poll.
FLUX 3 reference image aspect ratio: auto follows the first image
FLUX 3 Image defaults aspect_ratio to auto: the first reference sets the shape, or 1:1 with none. On Sume, omitting the field is not the same as auto.
FLUX 3 Image grounding is on by default: web search and Sume
FLUX 3 Image grounding defaults to true and can search the web and images before generating. Sume lists no such field; pass references to set the target.
FLUX 3 Image edit API: no mode field, just add references
FLUX 3 Image has one endpoint and no mode field: add images to edit, restyle or combine. On Sume you send input_references to an edit-capable model.
FLUX 3 API polling: the Reasoning status and Sume job statuses
FLUX 3 Image polls through Pending, Reasoning, Generating and Ready, and stops on four terminal states. Map them to Sume's queued to completed statuses.
FLUX 3 Image result URL expires after 1 hour: what to store
FLUX 3 Image's result.sample is a signed URL that expires after 1 hour. Download it at once; Sume returns Sume-hosted signed URLs in data[].url instead.
FLUX 3 Image API 422 unknown field vs Sume 400
FLUX 3 Image returns 422 for an unknown field, a blank prompt or a small reference. Sume returns 400 unsupported_parameter. Map the status codes in your client.
Gemini 3.8 Live migration errors and Sume's request-response audio
Moving to gemini-3.8-live: thinking_level unsupported, async function calling by default, proactive audio always on. Where Sume's audio jobs fit instead.
GeneratePMaxDraftCampaign IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
image_enabled=true on GeneratePMaxDraftCampaign returns IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED in Ads API v25.2. Leave it false and add your own images.
Goose MCP HTTP retries and Sume paid calls: reuse the key
When goose retries an MCP HTTP call to Sume, the same idempotency_key keeps a paid generate call a dedup, not a second job. Check status before resubmitting.
HeyGen get video scenes API vs Sume video inspect stills
HeyGen's scenes endpoint returns a typed composition. Sume's video inspect returns probe facts and stills for one hosted clip, not typed scenes.
HeyGen liveavatar-gpt-live-demos: where Sume's avatar jobs start
HeyGen's liveavatar-gpt-live-demos repo is a real-time avatar starter. Sume renders avatar video as jobs: submit async, poll or webhook, then fetch the MP4.
HeyGen create template via API: Sume has video_inputs, not templates
HeyGen now creates templates over the API and binds variables by element_id. Sume has no stored template object; send ordered video_inputs on each request.
HeyGen stale_edit_version 409 vs Sume idempotency_conflict
HeyGen returns 409 stale_edit_version when a template edit is out of date. Sume's 409 is idempotency_conflict: one key reused on a different payload.
Ideogram API 402 inflight_limit: fast vs slow queue, and Sume
Ideogram 4.5 returns 402 or 429 with reject_reason inflight_limit and a fast or slow queue. Sume queues jobs first, then returns 429 queue_full.
Ideogram 4.5 quality: very_low needs a source image
Ideogram 4.5 quality defaults to medium with source images and high without, and very_low needs sources. Sume's quality enum is catalog-gated.
Ideogram 4.5 size source: keep dimensions, and Sume aspect auto
Ideogram 4.5 size takes auto, source or WIDTHxHEIGHT; source needs source images. Sume's size is a tier shorthand; use aspect_ratio auto to match a reference.
Ideogram 4.5 edit images: 5 sources, first is edited, vs Sume
Ideogram 4.5 takes up to 5 source images, 25 MB each; the first is edited and multipart is required. Sume takes public HTTPS URLs as input_references.
Instagram Creator Marketplace Discovery rate limit: 5,000/hour
Meta raised the Creator Marketplace Discovery API cap to 5,000 calls per user per hour from 1,000. Sume's creator search has its own per-key budget.
Kling Avatar v2 audio formats vs Sume Fabric audio_url
fal lists MP3, OGG, WAV, M4A and AAC audio for Kling Avatar v2. Sume Fabric takes an audio_url plus a still; here is how the two inputs compare.
Krea 2 creativity parameter vs Sume's unsupported_parameter
Krea 2 exposes creativity as a tunable request parameter. Sume has no creativity field and rejects it with a 400.
Deprecation and Sunset headers before 410 Gone: Sume's old names
Krea's retired Kling endpoints send Deprecation and Sunset headers, then 410 Gone. Here is how to detect that in code and which Sume aliases still work.
LangChain invalid tool calls: what Sume returns on a bad call
After LangChain 1.4.3 repairs an invalid tool call, Sume may still return an isError result, such as tool_not_found with a hint. Keep the same idempotency_key.
LTX-2 license: models trained on its Outputs are derivatives
The LTX-2 Community License lists models trained on Outputs as Derivatives that must ship under the same license. What the text says and what it leaves open.
Luma uni-1: 9 references for images, 8 for edits, and Sume limits
Luma uni-1 takes up to 9 image_ref images, or 8 for image_edit because the source uses a slot. Sume ceilings come from each model's catalog entry.
Luma uni-1 output_format png or jpeg vs Sume's per-model enum
Luma uni-1 output_format is png or jpeg, and the model picks one from the prompt if you omit it. Sume lists formats per model; set it explicitly.
Luma uni-1 web_search grounding vs Sume's unsupported_parameter
Luma uni-1 accepts web_search: true to look up visual references before it generates. Sume has no such field and returns 400 unsupported_parameter.
Regenerate one rejected variant on Sume: use a new key
Luma Variants lets you regenerate any preview that is not right. On Sume a repeated Idempotency-Key replays the old job, so a redo needs a fresh key.
MAI-Transcribe-2 word timestamps vs Sume STT words[] shape
MAI-Transcribe-2 gives every word a start and end time. Sume STT always returns words[] as { word, start, end } in seconds, with no flag to turn it on.
MCP CORS preflight: headers Sume allows for a browser client
Sume answers an MCP OPTIONS preflight with 204 and lists authorization, content-type, idempotency-key, mcp-session-id and x-api-key for listed origins.
MCP error -32000 connection closed: what Sume's -32000 means
MCP error -32000 is implementation-defined. Sume returns it only when its MCP work budget is full; a client's own connection closed text is a different thing.
MCP Inspector custom headers: send one Sume API key
In MCP Inspector's custom headers, send either x-api-key or Authorization: Bearer with your Sume key, never both. Sume rejects a request carrying both.
MCP Inspector 405 Method Not Allowed on a POST-only server
Inspector 2.8.0 can suppress the standalone GET notification stream. Sume's MCP endpoint answers GET /mcp with 405 and Allow: POST, so turn it off.
MCP 403 forbidden: Sume forbidden_origin vs insufficient_scope
Python SDK 2.2.0 hands back any 403 that is not insufficient_scope. Sume's forbidden_origin is an HTTP 403; insufficient_scope is a tool result.
MCP Python SDK 2.2 protected resource metadata 5xx stops OAuth
Python SDK 2.2.0 stops the OAuth flow when protected resource metadata returns 5xx or 429. Curl Sume's two metadata URLs to confirm they return 200.
MCP Python SDK redirect rule: which Sume URL avoids a redirect
MCP Python SDK 2.2.0 follows redirects only within the endpoint's origin. Sume answers POST on https://mcp.sume.com/mcp and on the host root directly.
MCP validate_token_resource: the resource a Sume token is for
Python SDK 2.2.0 adds validate_token_resource for servers. A Sume OAuth token's resource audience is https://mcp.sume.com/mcp; confirm it in the metadata.
What are MCP extensions? Sume's capabilities list tools only
MCP 2026-07-28 adds an optional extensions field to client and server capabilities. Sume's initialize reply advertises only tools, with listChanged false.
MCP tools/list order and prompt caching: keying a Sume cache
Sume's tools/list returns one array in registry order with no cursor. Key your tool-list cache on credential and scope, and refetch when either changes.
MCP tools/list different per user: what Sume's list varies by
MCP 2026-07-28 says list endpoints no longer vary per connection. Sume's tools/list still varies by credential: OAuth read, OAuth write or an API key.
MiniMax H3 Fun ControlNet: 17n+5 frames vs Sume whole seconds
The H3 Fun ControlNet 2.0 card snaps frames down to the largest 17n+5 at fixed 24 fps. Sume takes whole-second durations instead. Worked frame math.
MiniMax H3 ControlNet 2.0 v1 config: a silent load_state_dict failure
Loading the v1 5-block config on the 2.0 checkpoint drops control_blocks.5~9 without an error. Use the post_norm config. Sume rejects bad fields with a 400.
MiniMax H3 license: 'Powered by' notice vs required UI display
The MiniMax H3 license only encourages a 'Powered by' notice, but IV.2 requires 'MiniMax H3' on the UI of commercial products. Plus a Sume overlay plate.
MiniMax H3 license: no training other AI models on its outputs
Section V.3 of the MiniMax H3 license bars using the Works or their Outputs to improve any other AI model. What the clause and Model Derivatives say.
Muse Voice Transcribe 16 kHz mono PCM: ffmpeg vs Sume audio-detach
Muse Voice Transcribe wants mono 16-bit PCM at 24 or 16 kHz. On Sume, audio-detach with 16000 Hz and mono makes the STT input wav from a hosted video.
Muse Voice Transcribe WebSocket streaming vs Sume STT job waits
Muse Voice Transcribe streams audio over one WebSocket and returns cumulative partials. Sume STT is a job: wait up to 30 seconds, then poll status_url.
OpenAI Agents empty tool arguments: Sume no-argument tools
Agents SDK 0.22.1 fails closed on empty tool arguments. Sume's no-argument tools take {}, while paid tools need idempotency_key and cannot run empty.
OpenAI Agents SDK tool not found: what a Sume call returns
A hosted MCP tool name that differs only in - or _ gets a tool_not_found result with a Did you mean hint; a scope-hidden tool returns insufficient_scope.