Planlock in front of Sume MCP: approve the plan, then the calls
Planlock is an MCP proxy that enforces a human-approved plan. Where it fits in front of Sume's hosted MCP, and which Sume gates still do work behind it.
Agents
The Sume video agent from code: Agent Completions, scheduled runs, MCP tools and timeouts, programmatic tool calling, and guardrails for paid APIs.
Start with: What is a video agent? How Sume defines and runs one
Send product photos to the Sume agent API, get edited images back
Agent Completions takes up to 30 image attachments and a required spend cap, then returns generated images in output.images. When to use it over /v1/images.
Scheduled run cost cap: a per-run cap can only lower it
A scheduled Sume run defaults to a $1.00 cap. A per-run cap can only lower the schedule cap, never raise it. Here is how that differs from a direct Format call.
Can I create a Sume schedule over the API? Not today
Sume schedules are created in the dashboard with a cron and timezone or an API-only trigger. The API cannot create or edit them, but it can fire and read runs.
Guardrails for an AI agent that calls paid media APIs
Five guardrails for an agent that spends money: required cap, read before paying, idempotency keys, no secrets in logs, and a cancel path. Drawn from Sume docs.
Porting chat-completions code to Sume Agent Completions
Agent Completions takes system and user messages, rejects assistant turns, returns a 202 receipt, and does not stream. Here is what to change when porting.
Copilot Studio hooks fail open: cap paid media spend server-side
Copilot Studio hooks can block a tool call, but a failed hook lets the agent continue. Put the media spend limit where it can't fail open: the Sume run cap.
Gemini agent keeps memory for days; Sume API runs start fresh
Google's Gemini agent keeps one memory across devices and days. Sume's API runs start in a new thread, so state travels as input, files and previous_run_id.
Agent SDK verbatim_prompts vs Sume Agent Completions input
The Claude Agent SDK verbatim_prompts option stops @path and slash expansion of user text. Sume Agent Completions keeps input as data in a file. Compare them.
How to cap an AI video agent's spend: five limits, in order
A video agent has five separate limits: model budget, turns, per-call max_spend_usd, run cap and plan queue. Which stops a runaway Sume job, and which does not.
Codex worktrees run agents in parallel: one Sume queue
Codex CLI 0.162.0 adds managed worktree tools. Parallel agents in worktrees still share one Sume workspace: plan concurrency, queue and 429 queue_full apply.
Stopped a Sume MCP call in Claude Code? The job still runs
Stopping a long Sume MCP wait in Claude Code does not stop the render. The job keeps running and billing; find the job id, then wait again, read or cancel.
claude --fallback-model when overloaded: Sume paid calls
--fallback-model switches Claude Code to another model when the main one is overloaded. Sume's spend caps and idempotency keys are independent of the model.
Sume schedule run: communication.mode webhook alone sends nothing
On a Sume schedule run, communication.mode is descriptive only. Delivery starts when communication.webhook_url is set, an HTTPS URL up to 2,048 characters.
Sume API key with actions:read only: list schedules, not start runs
A Sume key with actions:read can list and read schedules and runs. Starting or canceling a run needs actions:write; keys made before the trigger lack both.
Should an agent tool take a workspace_id argument for Sume calls?
No. Sume's safe-automation guidance says the API key or app session selects the workspace and tools must not take a workspace id from the user.
Nano Banana 2.1 images per $1.00 scheduled run, by resolution
How many Nano Banana 2.1 images fit the $1.00 default cap of a Sume schedule: 13 at 0.5K, 10 at 1K, 6 at 2K, 5 at 4K, with the totals.
Agent Completion cap for three Wan 3.0 720p clips: $3.75 at 10 s
Three 10-second Wan 3.0 clips cost $1.875 at 480p, $3.75 at 720p and $7.50 at 1080p. How to pick generation_spend_cap_usd for each.
Agent Completion cap for ten Nano Banana 2.1 images at 2K: $1.50
Ten 2K Nano Banana 2.1 images cost $1.50 on Sume. Size generation_spend_cap_usd at $2 for headroom; 4K needs the whole $2.00. Table and curl.
Agent Completion: a 15 s MiniMax H3 clip plus voiceover, cap 1.50
A 15-second MiniMax H3 clip at 768p ($1.125) plus a 750-character voiceover ($0.035625) comes to $1.160625, so a cap of 1.5 is enough. Table and body.
MiniMax H3 768p clips inside a $2 Agent Completion cap
At $0.075 per second, a $2 Agent Completion cap fits 25 s of MiniMax H3 at 768p: one 15 s and two 5 s clips for $1.875. Table of the combinations.
Wan 3.0 clip lengths that fit a $1.00 scheduled run cap
A schedule without its own cap gets $1.00 per run. At Wan 3.0 rates that buys 16 s at 480p, 8 s at 720p or 4 s at 1080p; here is the table.
$1.00 scheduled run: a music bed, a narration and six images
A Sume schedule's $1.00 cap fits one $0.125 music bed, 5,000 characters of narration ($0.2375) and six 1K images ($0.60): $0.9625 in all.
A 5,000-character voiceover costs $0.2375: sizing the run cap
Sume text-to-speech is $0.0475 per 1,000 characters: $0.2375 for 5,000, $0.95 for 20,000. Use the table to set generation_spend_cap_usd on an Agent Completion.
A 20,000-character narration fits a $1.00 scheduled cap at $0.95
Sume TTS at $0.0475 per 1,000 characters prices 20,000 characters at $0.95, 5 cents under the $1.00 default cap of a schedule. What 21,000 does.
Animate a product photo with Agent Completions: $0.625 on Wan 3.0
Send one input_image and ask the Sume agent for a 5-second Wan 3.0 clip at 720p: $0.625 at $0.125 per second. Cap 1 is enough. Body and limits.
Seedance 2.5's 4-second minimum costs $1.07 at 480p 9:16
Seedance 2.5 accepts 4 to 30 seconds, and the shortest 480p 9:16 clip is $1.074709, over the $1.00 default schedule cap. Price points and what to do.
Agent run log allowlist: which Sume fields are safe to keep
Log request ids, job ids, status and sanitized media metadata from Sume agent runs; never log API keys, signed URLs, raw private media URLs or full transcripts.
Canceled and skipped Sume agent runs send no webhook: what to poll
A Sume run webhook fires only when a run completes or fails. Canceled and skipped runs send nothing, so your scheduler must read status_url for them.
Agent Completion attachments: 16 full-size images fit the 500 MB cap
An Agent Completion takes up to 30 images, each up to 30 MB, in a set up to 500 MB. At full size only 16 fit; for 30 images the average must be under 16.7 MB.
Your agent calls generate_video, or Sume's agent does: two meters
With hosted MCP your model client runs the loop and you pay its provider; with an Agent Completion Sume's agent runs it and you set generation_spend_cap_usd.
Five gates between a Sume MCP write session and your wallet
A hosted Sume MCP write session has five gates before money moves: scope, idempotency_key, dry_run, an optional max_spend_usd, and wallet admission.
Unattended agent: stop or retry on Sume 402, 409, 429, 503?
An unattended Sume agent should stop on 402, fix on 400, retry 429 and 503 with the same idempotency key, and never reuse a key after a 409.
script_run limits: timeout 5-55 s, max_calls and max_paid_calls
Sume's script_run runs a short script of MCP tool calls with a 5 to 55 second timeout and caps on calls and paid calls. What it returns and cannot call.
Scheduled run spend cap: a request can lower it, never raise it
A Sume schedule's per-run cap is min(request, schedule cap). A $3 request on a $1 schedule runs at $1; null removes the ceiling; 0 is a 400.
Agent Completions rejects assistant turns: how to carry chat history
Sume Agent Completions return 400 on any assistant message in messages[] and start a fresh thread each time. Here is what that means for multi-turn history.
Hourly Sume schedule worst case: 24 runs a day at the $1 default cap
If a Sume schedule has no spend cap set, each run is capped at $1.00 of generation. Hourly cadence means up to $24 a day and $720 over 30 days. Show the math.
Claude Motion makes MP4s from code: when a Sume Agent run fits instead
Claude Motion (beta, 2026-10-08) animates text and charts as code. Sume Agent Completions generate footage and return media URLs. Which fits which job.
Six locales, six Agent Completions at $2 each: a $12 worst case
One Agent Completion per locale, each with its own spend cap and Idempotency-Key. Six runs at $2 bound generation to $12, and a retry cannot start a seventh.
Daily Sume schedule: skipped and canceled runs send no webhook
A Sume run webhook fires only on completed or failed. For a daily schedule, a skipped or canceled run is silent, so add a list-runs check each morning.
Which Sume MCP tools to leave undeferred when Claude searches tools
Anthropic says to keep 3 to 5 frequently used tools non-deferred. Which Sume hosted MCP tools to pin and which to defer.
Haiku 5.5 effort for an agent that polls Sume jobs
Claude Haiku 5.5 defaults to medium effort. What that means for a loop that calls Sume jobs_wait, and when to move to low or high.
Use a low-effort Haiku 5.5 subagent for Sume dry_run previews
Anthropic recommends low effort for subagents, and warns it can skip checks. Where a Haiku 5.5 subagent fits in front of a paid Sume call.
Sume MCP avatar tools: 5 read-only and the paid create set
Hosted Sume MCP lists five read tools for avatars and avatar videos and a paid group for creates and previews. What OAuth mcp:read sees and the dry_run flow.
Scheduled run spend cap: a per-call number can only lower it
A Sume schedule's default generation cap is $1.00. A per-run number is clamped to the lower of the request and the schedule cap, and 0 is rejected.
What an agent should log when it calls Sume: ids yes, signed URLs no
Safe log fields for agents using the Sume API, CLI and MCP: request ids, job ids, status, sanitized media metadata. Never keys, signed URLs or transcripts.
Claude Code prompt hook: 30 s default, a model checks a Sume render
A prompt hook asks a model to review a tool call, with a 30-second default timeout. When that suits a Sume render and when a script check is the better gate.
Codex 0.161 defaults to GPT-6.1 Sol: recheck how it calls Sume tools
Codex 0.161.0 makes GPT-6.1 Sol the default model in bundled and Amazon Bedrock catalogs. Re-run a free Sume read and a dry run before trusting paid calls.