MCP

Bring your own agent.

Tonta ships a Model Context Protocol server so a customer's own agent — Claude, ChatGPT, Cursor, or anything else that speaks MCP — can plan, see, change, price and run real work from inside a conversation, with every creative system the web app has.

Who this is for

Anyone who already lives inside an agent and would rather ask for a reel than open a web app. A connected workspace works from Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, or any MCP client that supports Streamable HTTP — no code required on your side.

What your agent can do

Every system, chosen from the goal

Video, pictures, audio, motion design, Recast and app walkthroughs are all reachable. create reads the brief and works out which systems the piece needs, combines them in one plan and prices each system on its own line, so your agent can take one off and see what that saves.

createdescribe_capabilitieschange_piece_systems

It sees the work

The storyboard, your references and finished shots arrive as small captioned pictures next to the facts, so an agent that can look at images reviews the actual frames rather than a list of ids. Pictures are previews of your own material and never carry a link.

get_storyboardlist_referencesget_job_activity

Change the storyboard in words or exactly

Ask for a change in plain words and review the proposal before applying it, or make precise edits in one batch: move, lock or retime a shot, swap a model, choose a narrator or a character's voice. Each batch is one new version with its price change, and earlier versions can be compared or restored.

propose_storyboard_changesapply_storyboard_changesedit_storyboardcompare_plan_revisions

Cheaper and better options that fit the plan

Alternatives are only models that can do what the shot needs, with what each one costs and what it changes. Applying one is a new version, never a silent swap.

list_plan_alternativesapply_plan_alternative

27 interactive apps inside the conversation

In clients that show interactive apps, results open as views: the storyboard as a board you can rearrange, lock, retime and ask to change, voices with samples to play, models to choose from, an itemised quote, the job monitor, your library, a question card, the calendar and more. They can look and make changes that spend nothing, but none can start or spend: starting stays a step you take in the conversation or on the web.

get_storyboardlist_voicessearch_modelsget_quoteget_production_stepslist_library

Live updates and readable resources

Jobs, storyboards, shots, versions, references and a project's cast and bible are readable resources. Clients that support subscriptions are told when a storyboard or a run changes; the others wait with wait_for_job, which holds the call open, reports progress while the work runs and says what to do next the moment it finishes.

wait_for_jobget_plan_runlist_plan_revisions

It looks at and listens to your files

Your agent can inspect any file in the library: a picture as an image, a video as frames with their times, its length and whether it has sound, a recording as its length and transcript, a document as its text. Looking spends nothing.

inspect_assetlist_library

It knows what is new

Tonta keeps adding tools and features. whats_new lists what shipped recently, from the same changelog you read on this site, so a connected agent learns about a feature the day it arrives.

whats_newsearch_tools

Schedules and publishing, with a person in charge

An agent can draft a schedule, add topics, check its runway and schedule a post. Approving a schedule, approving what goes out to your accounts and recording consent stay with a signed-in person.

list_automationsadd_schedule_topicsget_schedule_runwayschedule_post

Free-form motion, written by your agent

When a block cannot say it, your agent writes the motion as a short program. It runs once in a sealed sandbox and becomes data we check, price and render like our own work, with exact errors and low-resolution previews on the way.

get_motion_skeletonlookup_motion_patternvalidate_motionpreview_motion_framesestimate_motionattach_motion_composition

Stills before clips

Ask to review the stills and the run stops after them. Your agent sees each shot's candidates as pictures, picks one per shot and lets the run carry on; making a still again is quoted first.

get_storyboardpick_stillestimate_frame_regeneration

Frame sets: frames now, video later

Ask for the frames of a video without the video. Your agent can reorder, replace or take out frames, export them with a timeline file, and later price a video from them or open them on the timeline.

list_frame_setsget_frame_setreorder_frame_setreplace_frameexport_frame_setestimate_frame_set_videoopen_frame_set_as_composition

Edit a finished piece on its timeline

Read a piece's tracks and clips and change them in batches of edits that spend nothing: trims, freezes, reverses, masks, keyframed motion, overlays and a clip's own sound. Your agent sees the frames exactly as the render draws them, corrects what is off, and can pick up or discard an unfinished edit later. Rendering costs nothing up to a daily allowance once the workspace has paid; anything an edit generates is quoted first.

get_compositionedit_compositionget_composition_frameslist_clip_actionslist_compositions_in_progressdiscard_composition_editslist_composition_revisions

Parts, one or many

Make the things a video is made of rather than a finished piece: a clip, pictures, a voiceover, music, a sound effect or a 3D model, or N variations as one job. The quote has one line per item, and an item that does not finish is not charged.

generate_partgenerate_parts_batchget_partlist_parts

Edit a file you already have

Upscale a picture or a clip, remove a background, extend a picture, reframe a clip or change a voice. Your agent sees what can be done to the file and with which models, and gets a quote before anything runs.

list_asset_operationsestimate_asset_operationget_asset_operation

What this connection can never do

Not policy on a page — the server has no code path for the things below. An agent connected here is bounded structurally, not by a setting someone could forget.

Workspace comes from the token, never an argument

No tool takes a workspace id. A tool that accepted one would be one prompt injection away from cross-tenant access — so that argument simply doesn't exist on this surface.

Spending always goes through a quote

There is no tool that takes a brief and a budget. create — the tool your agent reaches for first — classifies the brief, fills in the settings and returns a single-use, five-minute quote the same way estimate_job does; submit_job requires it. Unpriced spending isn't guarded — it's unrepresentable.

No agent's claim of approval is ever accepted

There is no confirmed: true parameter, because a parameter an agent can set is a parameter an agent will set. Above your confirmation threshold, Tonta never asks inside the assistant's conversation: the job is parked and the assistant gets a web approval link. You open it, sign in and approve it yourself, and only then does it run.

Money writes and impersonation are absent from the surface

Buying credits, changing a plan, deleting a workspace or a member, reading another workspace's anything, and any staff operation are not permission-checked here — they simply aren't reachable from this server.

Every call is audited

Actor, connection, tool, arguments, quote, cost and result are recorded on every call — the same trail a human console action leaves.

Bounded by a cap you set, independent of your plan

Each connection carries its own per-job and daily spend cap, editable from Settings. A confused or compromised agent is bounded by a number you chose, not the whole workspace's plan. An owner may pre-approve an API key up to an amount per job and per day; that is a person's standing yes, set while signed in, and never something an agent can grant itself.

Consent and publishing approval stay with a person

Recording consent for a voice or a likeness, approving a schedule and approving what goes out to your social accounts are not tools. An agent can prepare all of it; a signed-in person says yes.

Pictures and briefs are content, not instructions

Text in a brief, a caption or inside a picture is treated as material to work with. Every app shows it as plain text, none can call a tool that spends, and the server refuses to load an app that ever could.

Free-form motion

Write the motion yourself. We run it safely.

When a block cannot say it, your agent can write the composition as a short JavaScript program against our motion runtime. It runs once, in a sealed sandbox, and becomes plain data we check, price and render like our own work.

Write it free-form for

  • Kinetic type timed to the beat or to the words of a voice-over
  • A logo sting or brand animation no block expresses
  • A data reveal with your own numbers
  • A product shown on a turning 3D plane, or a simple 3D scene
  • Shader backgrounds and particle fields in your brand colours
  • A walkthrough choreographed over your own screenshots
  • A Lottie you already have (an icon, a sticker), played frame-exact
  • A reusable template: swap the words, colour and logo without touching the program

Let blocks do

  • Standard titles, lower thirds, captions and end cards
  • Anything that needs a generated picture or clip inside it
  • Video footage inside the composition (free-form shows stills)
  • Pieces longer than 60 seconds, or at 60 fps

The loop

  1. 1get_motion_skeletonA composition that already builds: scenes on the beat or on the voice lines, the safe area, your references, and the runtime reference.
  2. 2lookup_motion_patternFifteen vetted worked examples to adapt: kinetic type, logo sting, lower third, charts, product in 3D, map route, split screen, countdown, quote card, UI walkthrough and more.
  3. 3measure_textYour brand fonts' real metrics: the width and line breaks of your words, or the largest size that fits a box.
  4. 4get_beat_and_word_timingThe beat grid and the voice-over word timings a draft composes against, each saying whether it is measured or estimated.
  5. 5validate_motionRuns the program and checks the result. Exact errors, each with a code, the line, the element and a fix.
  6. 6preview_motion_framesUp to four low-resolution stills at the times you choose, through the same renderer as the final render. No charge.
  7. 7estimate_motionThe render's price per stage and per second of output, its effects class, and the render-time cap.
  8. 8attach_motion_compositionPuts it on a draft. Then resume_draft for the quote and start_job to run it. Nothing is spent before that.

Your program never reaches the page

It runs once, before rendering, and returns data. Our compiler turns that data into the page, with every word escaped, so nothing you write is ever executed where the video is drawn.

A sealed sandbox

No network, no files, no clock, no eval, no modules. A fresh interpreter for every build, with a hard time, memory and stack budget, and nothing shared between builds.

The same rules as our own work

Our own motion author goes through the identical sandbox, checks, caps and quote. An agent's program gets no path ours does not.

Priced before it runs

The quote binds to the exact program and result that were checked. If anything changes, it is checked and quoted again.

In time with the sound

On the beat

Beats and bars are re-timed at render to the music the piece really has, measured from the track. Every beat-timed moment lands within one frame of it.

On the voice

Lines follow the measured read of the voice-over, each line starting on a real pause; the words inside a line are spread by length. Word-by-word timing is estimated within each line.

Sounds on the cut

Sound effects you place move with the timing, so an impact still lands on its cut.

The price does not move

The quote is for your program, not for the seconds it lands on. If the music has no steady pulse, or there is no voice-over, the timing you checked is the timing that renders.

Bring a Lottie and it plays frame-exact, through a player with no expression engine. Expressions are refused because they are code: bake them into keyframes before exporting. Pictures inside a Lottie must be your own references; font files and 3D or audio layers are refused.

Hard limits

Length and frame
1–60 seconds · up to 1080p · 24 or 30 fps · every aspect ratio
Program
64 KiB · builds in 2 seconds and 48 MiB
Elements
160 elements · 1,200 particles · one 3D scene of 24 objects · 2 shader layers
Pictures
Up to 12 of your own stills, by id — never a URL
Render
The priced render may not exceed 7 minutes of rendering
Preview
Up to 4 frames at 360 px, 20 an hour, no charge
Lottie
2 per composition · 200,000 characters · 3,600 frames · 120 layers · no expressions
Sound and templates
16 sound cues from the piece's own effects · 16 template parameters
Sync
Beats, bars and voice lines re-timed to the measured audio, within one frame

Free-form renders are priced like every motion piece: by the seconds of output and the effects they use. Standard motion, detailed effects (particles, a Lottie, very busy pages) and 3D effects (a 3D scene, a shader layer or a shader transition) cost progressively more to render, and the estimate says which applies and why.

Authentication

OAuth 2.1 with PKCE, in the browser. You authorise Tonta for one workspace the first time a client connects; access tokens are short-lived and refresh tokens rotate, and reusing a rotated token revokes the whole family. A client Tonta has never seen can still connect through Dynamic Client Registration (RFC 7591), so nobody registers it by hand. For a client that cannot run a browser sign-in, the same server also accepts a workspace API key as a bearer token, with that key's scopes and daily spend limit.

Connect a client

Claude Code

One command.

claude mcp add --transport http tonta https://tonta.media/api/mcp

Claude Desktop / Cursor

Paste into claude_desktop_config.json (or .cursor/mcp.json), then restart.

{
  "mcpServers": {
    "tonta": { "type": "http", "url": "https://tonta.media/api/mcp" }
  }
}

ChatGPT / anything else

Settings → Connectors → Add connector → paste the URL.

https://tonta.media/api/mcp

Server URL: https://tonta.media/api/mcp — the same one every client above uses.

What it looks like

You

Using Tonta, what would a 30-second faceless reel about home espresso cost, before you make anything?

Your agent

I'll estimate that with Tonta first. Three shots, cinematic preset, 9:16 — the quote comes back at $2.14 and is good for five minutes. Want me to submit it?

You

Yes, go ahead.

Your agent

Submitted. I'll watch it — plan is done, shots are generating now. I'll show you the cut here as soon as it's ready to review.

Not only reels

  • Review and change a storyboard

    “Show me the storyboard. Move the logo shot to the end, keep the oven shot as it is, and give the narrator a warmer voice.”

    The agent shows the frames, then sends the three changes as one edit: a move, a lock and a voice. That makes one new version with its price change, and resume_draft returns the fresh quote for you to approve.

    get_storyboardlist_voicesedit_storyboardresume_draft

  • One piece, several systems

    “Introduce our app to new users: use this screen recording and our logo, pull the facts from our site, and add animated titles.”

    create works out that the piece needs an app walkthrough, motion design and a voiceover, combines them in one plan and prices each one. Drop a system with change_piece_systems and the agent tells you what that saves.

    request_uploadconfirm_uploadcreatechange_piece_systems

  • A 3D model

    “Make a 3D model of a ceramic espresso cup from this product photo.”

    The agent uploads the photo, calls create with service model3d_generation and the photo as sourceAssetId, and shows you the quote. After you approve it, submit_job runs it and you get a 3D preview to look at before anything else happens.

    request_uploadconfirm_uploadcreatesubmit_job

  • Narration and audio

    “Record this script as a warm, unhurried voiceover and give me a matching music bed.”

    The agent reads the voices you can choose from, calls create with your script, and shows the quote. Narration is priced from the script's length, so the price comes after the text exists. submit_job runs the quote you approve.

    list_voicescreatesubmit_job

  • A transcript from a recording

    “Transcribe this interview.”

    The agent uploads the recording, calls create with it as sourceAssetId, and waits with wait_for_job. When the job finishes, the transcript is its result.

    request_uploadconfirm_uploadcreatewait_for_job

Every tool your agent can call

Read straight from the same contract the server is generated from — 305 tools today. No schemas dumped here; your MCP client reads those directly from the server on connect.

Read (158)

get_ad_batchRead an ad batch: each variant with its angle, hook line, shape, state, price, charge and file, grouped for comparison.
get_assetOne library asset: its details, tags and retention. Use open_library_asset for a link to the file.
get_asset_lineageWhere a file came from (the file an edit was made from) and the edits made from it.
get_asset_operationRead one edit of a file: its state, price, charge and the new file once it is ready. Progress also arrives as the job’s own events.
get_asset_thumbnailsLook at up to 12 of your files by id: an assistant receives each as a small picture (a clip as its key frame), captioned. Ids that are not yours are left out. Never a link; for the file itself use get_download_link. Spends nothing.
get_asset_usageWhere an asset is used, and whether it is safe to archive.
get_auto_refillToday's automatic top-up setting, without changing it.
get_automation_planWhat this automated service will do: aim, output, cost, schedule and references — built and persisted as the current draft.
get_automation_readinessWhether a service may run unattended right now, and what is blocking it.
get_balanceCredit available now, and what is reserved against running work.
get_beat_and_word_timingThe beat grid and the voice-over word timings a motion item composes against: the beats (measured from the piece's music once a run has measured it; the stated tempo before), and each voice line with its words' times (estimated from the line before the narration exists). Each says which.
get_block_adjust_optionsA shot's adjustable fields, their bounds, and each option's price delta.
get_brand_form_specThe setup form for one kind of brand: sections, fields, labels and help.
get_brand_profileOne brand, its offerings, and what we know about it.
get_calendar_layersOne window of the calendar: posts, projected schedule slots, closures, events - filtered, bucketed by your time zone.
get_capacityHow much work you can run right now: jobs at once, your queue with positions and waits, this hour, what more you can buy, and your own rate limits.
get_caption_trackA piece's captions: the lines, the style, and the subtitle files.
get_compositionA finished piece as a timeline you can edit: tracks (video, overlays, text, captions, voice, music, effects), clips with trims, speed, keyframes, looks, effects and transitions, markers and the mix. Name the piece, or the job that made it. Spends nothing.
get_composition_framesLook at a timeline at given moments: the frames of one revision at up to 12 times on the piece’s clock (milliseconds), exactly as the render draws them (small, watermarked), each with a short-lived link. Use it after edit_composition to check an edit (a freeze, a reverse, a mask, keyframed motion, overlays and blends) and correct it. The first look at a revision makes its small preview, so the answer may be `rendering` with `retryAfterMs`: ask again then. Never charged; it uses the day’s preview allowance once per revision. Links expire at expiresAt: look now, never store them.
get_composition_previewWhere a preview of a composition is, and once it is ready a short-lived link to play it (360p, watermarked). The link expires at expiresAt: play it now, never store it. A preview cannot be published or downloaded as a piece.
get_connect_unlock_statusWhether this brand can connect new accounts, and what is left to unlock it.
get_connection_healthHow one connected account is doing: the last check, what it found, the last publish, when it is next checked and what is waiting on it.
get_connection_limitsYour own remaining spend budget for this credential, right now.
get_content_statsPieces produced and published, itemised by service.
get_download_linkGet a short-lived link to download one of your files. It expires at expiresAt; fetch it now, never store it.
get_dub_scriptRead the script of a dub planned with scriptReview: each line as said and as translated, ready to correct before any voice is paid for. Spends nothing.
get_entitlementsWhat your plan and add-ons allow.
get_frame_setOne frame set: its frames in order with their pictures and scene notes (what each shows, the suggested motion, length, transition, camera and look). Spends nothing. To put it on a timeline: open_frame_set_as_composition (the whole set, its suggestions kept), or create_composition_from_assets with the frames you want, in your order.
get_insights_audienceAudience demographics, follower activity by hour and follower flow, per connected account that offers them.
get_insights_dashboardEverything Insights knows about the connected accounts for a range: account readings per platform, the account's posts (including ones made outside Tonta), engagement rate, per-platform split, posting-time heatmap, and the same figures for the period before.
get_insights_overviewHeadline metrics for a range against the equal-length period before it.
get_jobRead a job, its progress and what it has cost so far.
get_job_activityWhat this job is doing right now, step by step.
get_job_bibleThe production bible a run was made from (its cast, places, products and shots), and which revision of the project bible it used.
get_job_canvasThe stages of a job, how they depend on each other, and the takes each shot has produced so far.
get_job_creditsHow a job was actually made: every contributor (each shot’s clip or picture with its model by public name and the take kept, its opening and end stills, reference pictures, 3D scene, voice-over, music, sound effects, captions, lip sync, assembly), what each was made from (your references by name; references the brief only learned from are listed apart), the fallbacks and retries in plain words, and what each was charged, with totals that match the job’s charge. Spends nothing.
get_job_frame_setThe frame set a job makes: `making` (with how many stills are done) while it runs, `ready` with the set once it is made, `failed` or `canceled` (with `failure.message` in plain words) when the job stopped without making it, `none` for a job that makes no frame set. Spends nothing.
get_job_publishingWhere each of a job's pieces is scheduled or published, and the fields each post carries.
get_model_shot_compositionTurn one of your own 3D models into a short video clip: a ready FREE-FORM composition that shows the model (a turntable, an orbit, a slow push-in, or a hero rise), playing one of the animation clips the model file carries, if it has any, with what rendering it costs. Nothing is spent: attach the composition to the motion item of a draft with attach_motion_composition, read the draft back with resume_draft for the quote, and start it with start_job. You may change the program before attaching it (validate_motion checks it). Moves: turntable, orbit, push_in, hero_rise. 2 to 20 s (default 6). Background "transparent" makes an overlay. Priced as 3D effects.
get_motion_picturesA job’s motion graphics, item by item (an overlay, an animated ending, a motion piece): where each stands and its draft and final render, each sent as a small captioned picture of its key frame. For a playable file use get_download_link with the asset id.
get_motion_skeletonStart a FREE-FORM motion-graphics composition: a complete composition to fill (frame, scenes on the beat or the voice lines, safe area, references, a seed, and a JavaScript program that already builds), with the runtime reference (every tonta.* helper and its limits), the vetted shader transitions and the beat and word timing. Use free-form for bespoke kinetic type, logo stings, data reveals, a product on a 3D plane, shader or particle backgrounds, a walkthrough over your own screenshots, or motion design over and around your own clips (declare a video asset or reference and play it with tonta.video); use the block-built motion of create for standard titles, lower thirds and end cards. Then: lookup_motion_pattern, validate_motion, preview_motion_frames, estimate_motion, attach_motion_composition. Limits: up to 60s, 480p/720p/1080p, 24 or 30 fps, 160 nodes, 1200 particles, one 3D scene of 24 objects, 2 shader layers; the program builds in 2s and 48 MiB with no network, files, clock, eval or modules; the priced render may not exceed 420s of rendering. Clips play as layers (tonta.video: up to 4, trimmed with in/out and from, time-mapped with speed or a rate ramp, muted, priced as footage); a picture or clip shows only once it exists: generate it first (it lands in the library), then declare it as a reference by its asset id. Lottie: 2 documents of 200k characters and 3600 frames, no expressions, images only as your references. Sync: tonta.beat/bar/word/line times are re-resolved to the MEASURED music and voice at render (within one frame); the quote binds the program, not the seconds.
get_partRead a part run: each item with its state, price, charge and asset. Progress also arrives as the job’s own events. Its pictures go on a timeline, with nothing generated, through create_composition_from_assets (their assetIds, in your order).
get_piece_editA finished piece as an edit you can change: its shots, voice-over, music and captions.
get_plan_runRead a background plan: what it is doing now, then the plan, a question, or why it could not be made, with the next call to make (nextAction). Over MCP each call waits up to 20 s and returns the moment the plan is final.
get_post_analyticsOne published post's latest metrics and their time series.
get_production_stepsHow a multi-step production is made: each step (a still, a clip made from it, an edit of a clip, a sound), what it is made from, where it sits in the cut, its model by public name, and the take it has made so far, each sent as a small captioned picture. Spends nothing.
get_projectRead a project, its recent jobs and its latest export.
get_project_bibleRead a project's recurring cast, places and products.
get_project_readinessWhether this project has the knowledge it needs, and the next question to ask if not.
get_project_rightsThe brand assets and music a project uses, each with the basis you stated for using it, or none yet. A piece that uses one with none is not scheduled or published.
get_project_storyRead a project's story: its arcs and episodes, scenes, canon, threads and episode recaps.
get_project_storyboardA project's storyboard: each episode's shots, grouped under its scenes.
get_quoteRead a quote: what it priced, whether it needs approval, and whether it has been used.
get_recast_analysisWhat a Recast job found in its clip (the scene of each shot, how hard it is, who is in it), who or what it replaces, how the tracking went, and the question it is waiting on with the picture to answer it from (a short-lived link). Spends nothing.
get_referenceOne reference, with its current images in conditioning order.
get_reference_role_suggestionsServer-owned suggested asset roles for a reference kind, before any reference exists.
get_reference_splitHow a reference split is going and, once done, the references it made.
get_reference_split_offerThe separate things a reference picture shows, offered as references of their own (null when there are fewer than two), and the latest split.
get_sceneRead the current state of a scene: objects, cameras, lights, rigs.
get_schedule_goal_suggestionThe goal shown on a schedule's approval step: its agreed goal if it has one, else a suggestion to accept with the approval.
get_schedule_healthHow healthy one schedule is, and the one action that fixes each thing costing it points.
get_schedule_plan_biasWhy the plan leans the way it does: which pillars earn more turns, and any upcoming event it leans toward.
get_schedule_runwayHow many more runs your credit and monthly cap cover, and when the next run is.
get_schedule_setup_defaultsWhat a new schedule for this project starts from: connected platforms, a weekly slot grid, approval, budget and disclosure, each with where it came from.
get_scheduled_postOne scheduled post, the same piece on other platforms, and what has happened to it.
get_season_statusHow a series' automated season stands: the episodes planned ahead of the one being made, what is planned to happen, what waits for your decision, and whether changes are kept automatically.
get_service_settingsA configured cadence's full settings, plus what each unset field resolves to — read-only.
get_shot_outputsEvery shot of a job as it stands: its model by public name and length, its status, how many takes it has, the take in use and the picture it opened on, plus what the job delivered (`deliverables`: each finished file by assetId, for every output kind, including a voiceover or sound that has no shots) and its motion graphics (`motion`: each item's draft render, there mid-run, and its final render, by assetId). Shots are numbered from 0 (`shotIndex` 0 is "Shot 1"); a tool that takes a `shotKey` takes this same number (as a number, its digits or "shot:N"). An assistant also receives a small picture of each. For a playable file use get_download_link with an assetId. Spends nothing.
get_showcase_prefillStart Create from a showcase item.
get_skillHow to work with Tonta: the rules, the create flow, which tool does what, and what to do when a call is refused. Read it first (path SKILL.md, the default), then any file it links (files lists them). The same text as skill://tonta/SKILL.md, for a client without resources. Spends nothing.
get_spend_summaryWhat your credits were spent on, itemised. With no window given, the last 30 days up to now; the answer says the window it used.
get_storage_usageWhat your library stores against your plan allowance, what storage and delivery above it would cost, and what you could free.
get_story_entityOne cast member, place or product.
get_story_entity_pageA cast member, place or product with where it appears and how it changed over the story. Its history and comments are read with list_story_history and list_story_comments.
get_storyboardThe storyboard of a job’s plan: shots with their structured fields, lengths the model makes, sound, lines, transitions, scenes, cast and places, the reference pictures the piece makes for itself (planned, being made, made or not made, and why one is not made), and each shot’s opening picture once it exists, and every stated item of the brief with where the plan uses it (`requirements`). Spends nothing.
get_subscriptionYour plan, when it renews and what it will cost.
get_treatmentHow a draft will be made: what the piece is for, its hook, beats, pacing, sound and the systems it uses, each with why in fixed words, where it came from (you asked / suggested) and whether it can be taken off. `applied`: the plan was made with it (the same card Create shows); `shadow`: recorded for comparison only. Spends nothing.
get_video_identityWhether the person in this video can be offered as a voice, a look and a place, and whether you have confirmed it.
get_voice_consent_recordingRead a recorded consent: the words to read while it is open, then whether it was confirmed, refused or is being checked by a person.
get_voice_designRead a voice design: its quote, whether it is being made, and the voice once it exists.
get_voice_design_suggestionA description of how a voice sample sounds (pitch, pace, tone, accent), to start a designed voice from with estimate_voice_design. Never a clone. Null while the sample is being listened to or when nothing was measured.
get_voice_previewPlay one of your own voices before choosing it: a designed voice’s preview, or the recording a cloned voice comes from, as inline audio (base64). Spends nothing.
get_voice_samplePlay a stock voice before choosing it: its short sample as inline audio (base64), or why there is none yet. Spends nothing.
get_workspace_plan_reviewWhether this workspace always reviews the plan before a Create request runs.
get_world_bibleRead a project's world bible: tone, era, visual style, lore, glossary and rules.
list_account_metricsDaily account-level readings (followers, reach, impressions) per connected account.
list_ad_batchesYour ad batches, newest first, paged. Started ones by default.
list_asset_operationsWhat can be done to one of your files (upscale, remove background, extend, reframe, change voice), with the models that can do it and about what each costs for this file.
list_automationsEvery service this workspace has configured, and whether each is ready to run unattended.
list_block_attemptsA block's version history.
list_brand_eventsA brand's calendar — launches, sales, seasons, appearances.
list_brandsThe brands you can make content for: id, name and kind, to name one on other calls.
list_calendarScheduled posts between two dates.
list_caption_stylesThe caption styles a piece can use.
list_caption_templatesThe caption templates a composition’s captions can use, and the platform safe zones that keep them clear of each platform’s buttons and captions.
list_clip_actionsWhat applies to each clip of a timeline, as it is now: the free edit_composition changes that apply to it, the properties set_property can keyframe on it, and the PAID generative actions (cut out a background, take an object out, change a picture with words, upscale, reframe, change a voice, make a sound effect, picture or clip), each naming the tool that quotes it, start_job to spend that quote, and the edit that puts the new file on the timeline. Editing and rendering an edit are never charged; only these actions are, through their own quote. Spends nothing.
list_clip_backlogThe back-catalogue queue: what is waiting, how many clips remain and how long it lasts.
list_composition_revisionsA composition’s revisions, newest first, with what made each one. Undo is restoring one (edit_composition, restore_revision).
list_compositions_in_progressThe pieces whose timeline has edits saved since their last render (or never rendered), most recently edited first: continue one with get_composition then edit_composition, render it with estimate_render then render_composition, or set its edits aside with discard_composition_edits. Each says how many changes are waiting and gives its editor link. Spends nothing.
list_connectionsYour connected accounts and their health.
list_consent_blocksDrafts and scheduled runs on hold because permission for someone in them was withdrawn. They start again once planned without them.
list_content_languagesEvery language a service can write, narrate and caption in.
list_continuity_warningsEverything open about the continuity of a project: plans made before something changed, contradictions with the story, and cast past their review date. Each says where to fix it.
list_effectsThe effects a clip can carry, the moves a still picture can make, and the speed changes, each with its settings.
list_elicitation_optionsSearch every option an open question accepts.
list_entity_consentsThe consent records behind a person, voice or likeness in the story: who attested, as whom, and whether it was withdrawn.
list_entity_piecesThe pieces already made with a person or place. Listed, never deleted: a withdrawal leaves you the list to act on.
list_entity_statesHow a cast member, place or product changes over the episodes, in order, with the changes waiting for you to accept.
list_frame_setsYour frame sets (the stills a video would start on, made without the video), newest first, paged. Spends nothing.
list_goal_metricsEvery metric a goal may be set on.
list_goalsEvery goal for this workspace, grouped by whether it is proposed, active or past.
list_idea_categoriesEvery subject Tonta has ready ideas for (music, dance, history, animation, boxing and more), with its ideas.
list_insights_postsThe account's posts in a range (made in Tonta or imported from the platform), ranked by a metric.
list_insights_timeseriesA performance metric over time, across the posts published in a range.
list_jobsYour jobs, filtered and paged newest first.
list_libraryYour assets, filtered.
list_looksThe colour looks a clip can be graded with, each with what it looks like.
list_motion_blocksThe motion-graphics blocks, transitions and components a piece can use.
list_offersThe offers live for your workspace right now — read-only; accept one on the web.
list_partsYour part runs, newest first, paged. Started ones by default.
list_plan_alternativesOther ways to make a draft plan (another model or resolution), each priced against the quote on screen. Only a model that can make every shot it takes is offered: its frame, resolution and pictures, and its length (a clip may be made at a longer length the model offers and trimmed to the shot, so a stated total length is kept exactly; choosing it re-fits the lengths and re-prices).
list_plan_revisionsA job’s plan revisions, newest first, each with what changed from the one before.
list_platform_capabilitiesWhat each platform you can connect supports: media, caption length, links, scheduling. Only platforms available right now.
list_platform_prerequisitesWhat each platform needs before you connect it.
list_post_draftsYour unsent drafts, newest first (at most 100).
list_posting_slot_suggestionsBetter posting days and times for this schedule, from how your own posts performed. Suggestions only.
list_presetsThe presets this workspace may choose from, and what each can do.
list_project_castA project's cast, places and products with their standing choices, and the library's beside them.
list_projectsYour projects, filtered.
list_recast_templatesList the Recast template clips (clips Tonta owns or has licensed) you can start from. Empty until some are added: upload your own clip instead.
list_referencesYour references, and whether each may be used.
list_reshare_proposalsYour best published pieces that could be shared again, and whether re-sharing is on.
list_review_queuePieces waiting for your decision.
list_scene_compute_callsList a scene’s billed compute calls, newest first.
list_scene_projectsList this workspace’s 3D scenes, newest first.
list_scene_templatesList the starter 3D scenes you can begin from.
list_schedulable_contentContent cleared to schedule — moderation- and customer-approved — and which of your connections already carry it.
list_schedule_mix_adjustmentsWhat the weekly review changed in a schedule’s topic and format mix (or suggested for its posting times), newest first, each with why. Omit the schedule for the whole workspace.
list_schedule_topicsA schedule’s topic ledger: what is queued next, what was made, left out or suggested, where each came from, and whether it is running low.
list_servicesWhich services this workspace can plan and submit right now.
list_shot_takesEvery take of every shot of a piece, kept, with which one the piece plays now.
list_story_commentsThe comment threads on one story record, open threads first.
list_story_entitiesYour cast, places and products: a project's own and the library's.
list_story_historyThe history of one story record: every change, who made it, when and why, newest first.
list_story_introductionsNew characters, places and props proposed for a series, with what accepting does and what it costs.
list_story_proposalsThe changes to the story waiting for you to accept or reject (pending by default), with what would change and why.
list_story_stalePlans and pieces that depend on something in the story that changed after they were made.
list_story_templatesThe story templates you have saved: a project's arcs, episode outlines, open threads, facts and cast, without pictures or voices.
list_story_variantsThe alternate versions of one scene or episode, with the live record beside them.
list_supported_platformsEvery platform a cadence may target, with how well Tonta supports each.
list_top_piecesPieces ranked by a measured performance metric.
list_transitionsThe transitions a clip can arrive by (and the fades a last clip or overlay can leave by), each with what it looks like, the directions it takes and its default length.
list_trending_soundsThe platform’s own trending sounds for one connected account, to add to a video post by the platform’s sound id. Says so when the platform cannot take a sound from us. Never posts.
list_voice_libraryEvery voice you can speak in: the stock voices, the voices cloned from your own recordings and the voices you designed, each with whether it is ready and a preview to play. Spends nothing.
list_voicesThe stock narration voices a service can speak in. Filter by `language` (a BCP 47 primary subtag, "en") and `gender`, and page with `limit` and the `nextCursor` it returns: the whole catalogue is large, so an assistant should ask for a page.
list_workspace_add_onsAdd-ons you can buy on your current plan, and the ones you already hold.
list_workspace_factsWhat we know about the workspace as a whole (facts not tied to one brand), and what needs confirming.
wait_for_jobWhether a job has finished, failed, needs an answer or a person, or is still working: its progress (percent, stage, time left), its files once made, and the next call to make (nextAction). Over MCP each call waits up to 20 s and returns the moment the job settles; call it again while outcome is still_running.

Act (147)

accept_reference_proposalTurn a suggested library asset into a reference for one plan slot ("Use this?").
accept_scene_layoutAccept or decline the 3D layout proposed for a draft.
add_clip_backlogQueue existing videos, or older episodes of this schedule’s own feed. Adding never starts the drip.
add_schedule_topicsAdd your own topics to the end of the queue. An exact repeat is ignored; a near-repeat is returned in `repeats` and not added unless `allowRepeat`.
answer_project_questionAnswer one of a project's missing details from its readiness checklist.
answer_project_settingAnswer a question about what a project is about, who it is for, its themes, tone or goal.
answer_questionAnswer a question a job is waiting on, and let it continue.
answer_recast_trackConfirm the highlighted person or thing a Recast job will replace, or correct it: in words ("the man on the left"), or by marking a box or a point on the picture. The job then continues; the answer authorises nothing on its own and the price was already agreed.
answer_session_questionAnswer a session-level question that is not waiting on any one job.
apply_plan_alternativeChange a draft plan to one of the offered alternatives (a different model or resolution), keeping everything else about it. Returns the plan’s new price (estimateMicroUsd), which is not a quote. Spends nothing: read the draft back (resume_draft) for its new quote, and only that quote spends.
apply_scene_opsApply a batch of scene edits, never code, a closed, typed operation list.
apply_storyboard_changesApply the chosen changes from a storyboard proposal as one new plan revision. Read the draft back for its new price; restore the previous revision to undo.
archive_assetHide an asset from your library. Nothing is deleted. Refused while it is in use or under a hold.
archive_offeringRetire something a brand no longer sells or offers.
archive_projectArchive a project: hidden from the default list, cannot start work; its running schedule is paused.
archive_referenceArchive a reference: it stops being usable for new work. Nothing is deleted. Refused while a job is using it or it is under a hold.
attach_motion_compositionPut a FREE-FORM composition on one motion item of a DRAFT plan, in place of its block-built motion (its sound, placement and length stay). It is validated again here and nothing is written on any error. Spends nothing: read the draft back with resume_draft for the new quote, and start it with start_job. The quote binds to the exact program and graph that were checked.
cancel_jobCancel a job and release whatever credit it has not spent.
cancel_plan_runStop a background plan. Only the planning work already done is charged.
cancel_scheduled_postCancel a scheduled post before it goes out.
cancel_shot_retry_requestWithdraw a queued retry of a shot. Idempotent: one that is already gone is a success.
change_piece_systemsTake systems Create added from the brief off a draft (motion, an animated ending, music, a dub, a Recast...), or put them back, and get the re-planned draft with a NEW quote and each system’s own price line. Never starts anything: start the new draft with start_job and its quoteId. A setting you stated is changed in the settings, not here.
check_post_moveWhat would happen if this post moved to that time - nothing is moved.
check_scheduleWhat each chosen account would do with this piece at this time - nothing is booked.
compare_plan_revisionsWhat changed between two plan revisions and what each would cost now, priced by the same function as a quote (nothing is minted or held).
confirm_uploadConfirm a direct upload once the file has finished sending, and register it.
createDescribe what to make. Classifies, fills the settings, and returns a question, a priced quote, or the started job. Making the plan is charged for what it actually uses (usually a few cents; a small hold is reserved first and the rest released), apart from the quote and whether or not the piece is started; the quote states it as `planningChargedMicroUsd`. A motion piece written as code plans for more: writing it is charged at its actual cost with no margin, never above the bound `preview_create_price` gives as `planning.motionPieceUpToMicroUsd`. A brief may be long (a whole script, a shot list, or how to make it) and is never cut; a long one plans for a little more, and the quote says so. A brief or script that is a file goes in `briefDocumentId`. A stated length (`settings.targetDurationSeconds`, up to 600 s) is met exactly: each clip is made at a length its model offers and trimmed to its beat (`cutSeconds` on the plan), and a long piece gets as many shots as it needs. The plan lists every stated item of the brief in `requirements`, with where it is used and anything not in the plan yet.
create_brand_eventAdd a launch, sale, season or other event the plan should build toward.
create_brand_profileCreate a brand to make content for.
create_composition_from_assetsPut pictures (and clips) already in your library or frame sets on a new timeline, in the order you give, with no video model: each picture a still clip held for its length with a camera move (push_in, ken_burns, pan...), joined by an optional transition (one for every cut, or each item’s own), with empty voice, music, sound, overlay and text tracks. Nothing is generated or charged here. Then edit_composition adds words on screen, a voice-over and music, preview_composition checks it, estimate_render prices the render and render_composition spends that quote. Send idempotencyKey so a retry returns the same piece.
create_projectCreate a project.
create_scene_projectStart a new, persistent 3D scene.
create_service_subscriptionSet up a recurring content schedule (a cadence, for example three posts a week) for a service — onboarding, not yet approved to run unattended.
create_story_entityAdd a cast member, place or product to a project, or to the library. Everything saved here is what the customer stated.
create_story_variantBranch an alternate version of a scene or episode from the live record (or from another alternate). The live record is not touched.
curate_block_attemptPin or reject a regenerated version — never spends, never changes review status.
decide_topic_suggestionAccept a suggested topic into the queue, or dismiss it.
decline_quoteSay no to a spend that is above your confirmation limit.
describe_capabilitiesEverything Tonta can make and combine in one piece: each mode and sub-mode, each system (motion, picture operations, music, voice-over, dub, captions, Recast, lip sync...), what each needs, what it can be set to, how it is priced, whether a person must attest something, and what it combines with. Spends nothing.
describe_toolsThe full declarations (input schema, behaviour hints) of up to 8 tools by name, exactly as the tool list would carry them, so you can call a tool you found with search_tools. Names that are not tools come back in unknown. Spends nothing.
discard_composition_editsDiscard every timeline edit saved since the piece’s last render (or since the piece itself, when it was never rendered): the timeline returns to that state as one new revision. The rendered video and its history are not touched, files the edits added stay in the library, and the discarded revisions stay in the history (restore_revision brings them back). Send the revision you saw as `expectedRevision`: a change saved meanwhile is a `conflict` carrying `details.currentRevision` (read it again and decide). Safe to retry: a repeat answers `replayed`. Nothing to discard answers `discarded: false`. Spends nothing.
discard_post_draftDelete an unsent draft. Idempotent: one that is already gone is a success.
edit_compositionChange a piece’s timeline: add, remove, move, trim, split or duplicate clips (video, overlay or sound); speed and speed ramps; freeze a frame (freeze_frame, set_freeze) and play a clip or a stretch backwards (set_reverse, reverse_range); masks (set_mask: rect, ellipse, rounded_rect or a freeform path, feathered, inverted, keyframable); keyframes placed on each clip for zoom, position, rotation, opacity, edge crop, mask shape and sound level (set_property at a moment adds or updates the keyframe there; remove_keyframe, move_keyframe, set_keyframe_easing with linear, ease, hold or bezier); take a video’s sound out as its own linked clip (detach_audio, unlink_audio); overlays stacked by track order (move_track), anchored over a stretch of a clip (add_overlay_over_clip, anchor_overlay), blended, and picture in picture (set_picture_in_picture); looks, effects, framing and still moves; transitions in and out; text; tracks and sound clips with levels and fades; captions; the mix and loudness; markers; the trim and extra frames; restore a revision. Send one change as `edit` or up to 50 as `edits`, applied in order as ONE revision against `expectedRevision`, all or nothing. Every change is saved as it is made, so this is also how to continue a timeline edit left unfinished (find those with list_compositions_in_progress, read the latest with get_composition). A `conflict` with reason `composition_changed` carries `details.currentRevision`: read that revision and send the change again against it. A refused change is named (`details.editIndex`) with a closed `reason` and `options`, each priced. Spends nothing: returns the price before and after; estimate_render quotes it.
edit_dub_scriptCorrect lines of a dub script before the voice step: send the revision you read and each changed line. Saving the machine text again undoes an edit; an empty line is not spoken. Free; the voice is priced afterwards on the final text.
edit_plan_layersReplace a draft's layers: attached pictures shown in a corner (picture-in-picture) over a run of shots, and words on screen over a run of shots, in the listed corners, sizes, positions, styles and animations. Send the whole set; empty lists remove them all. Only pictures this draft offered for insets, and only shots the plan has. Spends nothing; returns the layers and the draft's price before and after. Start with the draft's next quote (resume_draft, then start_job).
edit_schedule_topicChange a topic that has not been made yet. Yours from then on: the idea engine never changes it. A title that repeats another is a 409 naming it, unless `allowRepeat`.
edit_storyboardChange a draft plan on its storyboard (reorder, split, join, duplicate or remove a shot; its fields, length, camera, model, lines, sound effect, transition or lock; its typed camera control - move, direction, pace, motion (`set_camera_control`; the result says whether the model takes it as a control of its own or from the description, with the models that take it natively and their price); the picture it ends on - the next or an earlier shot’s opening picture, one of the person’s pictures, or a final frame in words made with the other frames (`set_end_frame`, only on a model that can end on a picture: otherwise refused with the models that can and their price); the shot’s prompt in the person’s own words, sent to the model exactly as written (`set_prompt_mode` `expert` with `prompt`; `composed` goes back to the prompt arranged from the shot’s fields; still moderated, only picture tags, the no-music clause and exclusions are added); storyboard frames; who speaks in which stock voice; a production step’s model, timing or which earlier step it is made from; restore a revision). Send one change as `edit` or up to 20 as `edits`, applied in order as ONE revision, all or nothing. Returns the price before and after; read the draft back with resume_draft for the quote to start with. A model swap the new model can make only with another length, frame or rung is refused (`capability_conflict`, reason `substitution_needed`, each change named and priced) until it is sent again with `acceptSubstitutions`.
edit_treatmentChange how a draft opens (its hook) or its beats (their times and roles) on a plan made with a treatment. The change is recorded as yours and never re-inferred; the draft is re-planned and returned with a NEW quote. Never starts anything: start the new draft with start_job and its quoteId. Only on a draft whose get_treatment says `editable`.
estimate_asset_operationQuote one edit of one of your files: a new file, with the original kept. Spends nothing: start it with start_job.
estimate_block_actionPrice an in-place change to one block of a piece.
estimate_follow_onPrice the follow-on stage of a finished composed job (the dub into the languages it was planned with) from the piece as it was actually made, and return a single-use quote for it. Start it with start_follow_on and this quoteId; nothing is spent here.
estimate_frame_regenerationQuote remaking ONE frame as a picture part: `redraw` makes a new picture from the frame’s note (or your words), `edit` changes the current picture by your instruction and keeps its look. Spends nothing: start it with start_job, then swap it in with replace_frame.
estimate_frame_set_videoQuote a photo video made from this frame set, each frame its own moving scene in the set’s order, through the ordinary Create estimate. Change a scene’s motion, length or transition first with `changes`. Spends nothing: start it with start_job and the quote.
estimate_jobPrice a job and return a single-use quote for it.
estimate_motionWhat rendering a FREE-FORM composition costs: one line per stage (checks, draft preview, render, quality check; placing over the video for an overlay), the total, the render's price per second of output, its render-cost class (standard; detailed effects for particles or a heavy page; 3D effects for a 3D scene, a shader layer or a shader transition) and the render-time cap. An estimate, not a quote: attach it to a draft and resume_draft for the quote start_job spends against.
estimate_reassemblyCheck an edit and price only the new work in it.
estimate_renderCheck a revision of a composition and price rendering it (only the new work: changed speech, a new soundtrack, our own rendering time). Returns a single-use quote bound to exactly that revision on exactly that piece; render_composition spends it.
estimate_scene_actionPrice one scene action before committing to it. The price is a ceiling (up to): it covers the longest the action may run, and the charge is what it actually uses, usually much less and never more.
estimate_schedule_budgetCheck a schedule's budget against what its cadence costs.
estimate_shot_regenerationPrice a regeneration of one shot from your own brief, bound to the exact text that will be used. Name the piece (contentPieceId, not the job) and the shot (shotKey, counted from 0 like get_shot_outputs’ shotIndex), and send back prepare_shot_regeneration’s prompt and brief. Spends nothing; submit_block_regeneration redeems the quote.
estimate_voice_designPrice a voice designed from a description (who it sounds like in words: age, tone, pace, accent; never a real person). Returns a voiceDesignId with its quote; spends nothing. renewsReferenceId designs again a designed voice that was dropped after a week unused.
export_frame_setA download link (valid for a few minutes) for the whole set as one zip: numbered frames in order, manifest.json with every scene note, and the timeline as OTIO and EDL for an editor. Spends nothing; ask again for a fresh link.
export_motion_overlayExport a finished transparent motion overlay (titles, lower thirds, stickers over a shot) for use elsewhere: as WebM VP9 with alpha (browsers, web players, most editors) or a zipped PNG sequence with alpha (any editor). Returns the new file as an asset of the job; fetch it with get_download_link. No charge; asking again returns the same file.
generate_ad_batchQuote N ad variants of one offering (angles x hook lines x shapes) as ONE job: one quote that is the sum of its items, one hold; a failed item is refunded. Spends nothing: start it with start_job.
generate_partQuote one part (a clip, picture, voiceover, music, sound effect or 3D model) made by one model from your words. Spends nothing: start it with start_job.
generate_parts_batchQuote a batch of parts as ONE job: N variations of one prompt, or one item per prompt. One quote that is the sum of its items, one hold; a failed item is refunded. Spends nothing: start it with start_job.
import_scene_assetImport an existing 3D asset into a scene as a referenceable handle.
inspect_assetLook at or listen to one of your files: a picture comes back as an image, a video as up to 8 frames with their times plus its length, shape, whether it has sound and its transcript when one is stored, a sound as its length and stored transcript, a document as its text. Spends nothing (a new transcription is never made here). For the file itself use get_download_link.
lookup_motion_patternThe vetted FREE-FORM motion patterns (kinetic type, logo sting, lower third, bar chart, line chart, product on a 3D plane, map route, split screen, countdown, quote card, UI walkthrough, shader backdrop, particles, words on the voice-over, a 3D hero): search by words or category for the list, or ask by id for one worked program to adapt, returned as `{ language, source }`: the shape a composition's `program` takes, so it goes in as is. Each says when to use it, the references it needs and its render-cost class.
make_ad_variant_pieceMake one finished ad variant publishable: returns the piece its file is published as (made once per file; a repeat returns the same one). Publish it with get_publish_context and schedule_post_multi. Spends nothing.
measure_textMeasure words in the fonts a motion composition renders with (the brand kit's faces, by role): their width as a share of the frame and their line breaks at a size, or the largest size that fits a box. The same metrics the sandbox and the validator use, measured on the high side, so "fits" means fits.
open_frame_set_as_compositionThe frame set as a timeline to assemble later: each frame a still clip at its suggested length, camera move and transition, with empty voice, music, sound, overlay and text tracks. Edit it with edit_composition, preview with preview_composition, price with estimate_render and render with render_composition (its contentPieceId). Spends nothing.
pause_automationStop a running cadence. Scheduled runs stop; nothing already queued is cancelled.
pick_stillPick which picture a shot uses while the job is stopped on its stills review (get_job partialPause.frames): one of its candidate stills, or the result of a finished edit of one. Free: nothing is made or spent. Repeat to change the pick until the job goes on.
place_storyboard_shotMove a shot under a scene of its episode, or back to not placed. This arranges the board; it does not change the finished piece.
plan_recastPlan a Recast before paying: the shots, who or what is replaced, the opening pictures, masks and quality checks, the steps that are priced, or the question that must be answered first. Spends nothing; start it with create (settings.video.subMode "recast"). The person starting it must confirm consent for anyone shown, which an agent cannot do for them.
plan_take_choiceBuild the edit that puts a chosen take in its shot. Nothing is changed or charged: price it with estimate_reassembly and start it with start_reassembly.
prepare_shot_regenerationTurn your own description of a shot into the text it will be asked for, before anything is priced.
preview_compositionA small, fast preview of one revision of a composition (360p, up to three minutes), to check timing and moves before rendering. Never charged; a daily allowance of preview time applies. A preview cannot be published or downloaded.
preview_create_priceThe live price of the Create settings, and what each option would change.
preview_motion_framesRender up to 4 low-resolution stills (360px on the long edge) of a FREE-FORM composition at the times you choose, through the same renderer as the final render, to see what the program draws. No charge (it runs on Tonta's own renderer and is recorded at our cost), limited to 20 an hour. The composition is validated first; an invalid one answers its errors and no frames. A long program with clips can take a few minutes: if the call times out, call it again with the same composition and times, and it picks up the same preview (or returns it once made) rather than starting over.
propose_goalPropose a measurable target. Always created proposed, never active.
propose_scene_opsPropose scene edits for an instruction, without applying them.
propose_storyboard_changesSay in your own words what to change or include in a draft plan (the whole piece, or selected shots). Returns the changes it would make, each checked against the plan and priced, without changing anything; apply the ones you want with apply_storyboard_changes. Shots are numbered from 1 here, as a person says them ("shot 1" is the first; `dropped[].shot` too); `scope.shots` and every edit_storyboard field take the 0-based shotIndex ("shot 1" is shotIndex 0). An API key or assistant gets the built-in reader (`assistant: person_only`): it understands explicit edits (a shot’s framing, length, model, lines, order); a free-form look ("make the light warmer") is not understood there, so change the shot’s prompt with edit_storyboard instead.
read_workspace_job_eventsA snapshot of every job still moving (and recently finished), for a live jobs list.
record_brand_factTell us something about this brand. From a signed-in person it is final and never re-guessed; from a key or an assistant it is kept as observed.
record_workspace_factTell us something about the whole workspace. From a signed-in person it is final and never re-guessed; from a key or an assistant it is kept as observed.
regenerate_motion_partMake one scene, one layer or one sound track of a draft plan’s motion graphics again (or mute a track), keeping everything else about the plan.
remove_clip_backlog_itemTake a video out of the queue before it is taken.
remove_frameTake one frame out of a frame set; the rest keep their order. Its picture stays in your library. Free.
remove_schedule_topicRemove a topic that has not been made yet. One the idea engine proposed is kept as left out, so it is never proposed again.
render_compositionSpend a render estimate and put the piece together from that revision of its composition, as a new version of the piece. Nothing already published changes; the new version publishes only once adopted.
reorder_frame_setPut a frame set in a new order: send every frame id exactly once, in the order you want. Free; changes only the set.
reorder_schedule_topicsSet the order of the queued topics. Send exactly the queued ids; a stale list is a 409.
replace_frameSwap a frame’s picture for a finished picture part (the job `estimate_frame_regeneration` quoted and `start_job` started). Free, and undone by swapping back. A picture still being checked, or held, cannot be used.
request_shot_retryAsk to retry one shot of a job that is still running. The retry is priced and confirmed once the piece exists; nothing is spent now.
request_uploadGet a direct upload URL for a file you are about to send — the browser uploads straight to storage.
reschedule_postMove a scheduled post to a different time.
restore_scene_revisionRestore an earlier version of a 3D scene as its newest version.
resume_automationStart a paused cadence back up, from its next scheduled slot.
resume_draftPick a saved draft back up from its saved plan: re-checked and re-priced as a fresh quote, ready to start. Read a draft back this way after changing it (edit_storyboard, apply_plan_alternative). Spends nothing.
retry_failed_jobRetry a failed job while its reserved credit is still held; otherwise get a prefilled new request.
retry_failed_postPut a failed post back for another attempt, or post one whose time passed ("Post now"). It goes out about a minute from now, through the same safe path every post takes. A post that may already be live is refused (409, `may_already_be_live`) until `acknowledgeMayAlreadyBeLive` says the person saw that warning (a person only: an assistant gets the post’s page instead).
revise_motion_pieceRevise the motion graphics of a FINISHED or FAILED motion piece without planning it again: send a new free-form composition, or a new program for the composition it was made with. It is validated as attach_motion_composition validates one and becomes a NEW draft (the original piece and anything published from it stay as they are); the shots, voice-over and soundtrack the piece already made are reused while unchanged, not made or priced again. Spends nothing: read the new draft with resume_draft for its quote, and start it with start_job.
save_cast_memberAdd or change one cast member, place or product of a project, with its standing choices, in one save. Everything saved here is what the customer stated.
save_post_draftSave an unsent post for one account. A draft is never published; scheduling it for real is a separate step.
save_project_bibleSave a project's recurring cast, places and products. Everything saved here is what the customer stated.
save_world_bibleSave a project's world bible. Every entry changed here is what the customer stated, and is never re-inferred.
schedule_postSchedule an approved piece to a connected account.
schedule_post_multi_agentSchedule one approved piece to several accounts. A closure move or a repeat booking needs the customer to agree in the web calendar.
score_piece_for_publishA pre-publish check of a finished piece for each platform: shape, length, the first two seconds, sound, captions against the platform’s buttons, readability. Explained, free, never blocks posting, and never a prediction of views.
search_modelsSearch the models Create can run now, each with whether it fits these settings, why not, and its price for them.
search_toolsFind tools you do not have loaded. Search by what you want to do (query), or browse one toolset; filter by effect (read, quote, change, spend). Results are ranked best first, each with a relevance score. With no query and no toolset it also lists every toolset and what it is for. Then load a tool with describe_tools, or call it with call_read_tool / call_tool. Spends nothing.
send_messageAdd a message to a conversation.
set_ad_winnerMark one finished variant of an ad batch as the winner (one per batch), or clear it with null. A variant with no finished file is refused. Spends nothing.
set_asset_tagsReplace the tags on an asset.
set_clip_dripTurn the back-catalogue queue on or off. On starts taking videos at the schedule’s rhythm and spends credit per video, so only the person turns it on; an assistant may turn it off.
set_draft_narrator_voiceChoose the narrator's voice for a draft before it starts, or clear the choice.
set_motion_word_timingChoose how words follow the voice-over in a draft's motion graphics. `measured_lines` (the default): each line lands on its measured pause and its words are spread inside it. `aligned`: every word lands on the moment it is spoken, by transcribing the read with word timestamps; it is a priced step (a "word timing" line on the quote, from the transcription rate), and the quote refuses when it cannot be priced. Writes a new plan revision and spends nothing; read the draft back with resume_draft for the new quote.
set_reference_assetsSet the ordered images behind a reference sheet, replacing whatever was there.
set_reference_brandChange a reference's brand, or clear it.
set_reference_kindReclassify a reference's kind. Moving into a kind that needs consent or rights (a person's likeness, a voice, a music track) makes it unusable until the person confirms on the web: the result carries that page's link.
set_schedule_topic_strategyChoose where this schedule’s topics come from: kept filled for you, only your own list, or fresh takes on your best pieces first. Changes no spend.
set_still_shot_controlChange a shot’s camera move or the picture its clip ends on while the job is stopped on its stills review (get_job partialPause.frames[].actions has camera or end_frame). Free: nothing is made or spent; the clip is made with the change.
split_referenceMake the chosen items of a picture into references of their own (see get_reference_split_offer). Runs in the background: watch get_reference_split. A person becomes a character reference that needs consent before use. Spends nothing.
start_follow_onStart the dubbing stage of a finished composed job. An API key or assistant first prices it with estimate_follow_on and passes that quoteId, which this spends exactly once; a person on the web may start it from the credit reserved with the job.
start_jobStart a planned draft from its quote.
start_reassemblySpend an edit estimate and put the piece together again as a new version.
start_sessionStart a new conversation with the planning agent.
start_voice_consent_recordingAsk for the words the speaker reads aloud to record their consent to a clone of their voice. A signed-in person only; an agent sends the person to the web.
start_voice_designStart a quoted voice design: redeems its quote and holds its credit. Above the confirmation threshold the person approves it on the web; your own statement that they agreed is never accepted.
submit_block_regenerationSpend a block-action estimate and start the regeneration.
submit_jobSubmit a quoted job for generation.
submit_voice_consent_recordingHand in the uploaded recording (60 seconds at most) of the speaker reading the words. Free; it is checked within minutes. A signed-in person only.
unarchive_assetBring an archived asset back into your library. Also cancels a delete made within the grace period.
unarchive_projectBring an archived project back. Its schedule stays paused until you resume it.
unarchive_referenceBring an archived reference back. A likeness whose consent was withdrawn needs a new consent record first.
update_brand_eventEdit an event on a brand's calendar.
update_brand_profileEdit a brand.
update_caption_trackEdit a piece's captions and re-render them. Free.
update_projectEdit a project's name, description, brand, brand use or settings.
update_service_subscription_settingsEdit a configured cadence's settings.
update_story_entityChange a cast member, place or product. The @-tag never changes.
upsert_offeringAdd or edit one thing a brand sells or offers.
use_block_as_referenceTurn an output into a reusable reference.
validate_motionCheck a FREE-FORM motion composition: its program runs once in Tonta's sandbox and every result is checked (shape, text re-measured and inside the safe area, references yours, the render-time cap). Answers ok, or exact errors, each with a code, the program line, the node and a fix. Your program is treated as untrusted code: no network, files, clock, eval or modules. Spends nothing. Limits: up to 60s, 480p/720p/1080p, 24 or 30 fps, 160 nodes, 1200 particles, one 3D scene of 24 objects, 2 shader layers; the program builds in 2s and 48 MiB with no network, files, clock, eval or modules; the priced render may not exceed 420s of rendering. Clips play as layers (tonta.video: up to 4, trimmed with in/out and from, time-mapped with speed or a rate ramp, muted, priced as footage); a picture or clip shows only once it exists: generate it first (it lands in the library), then declare it as a reference by its asset id. Lottie: 2 documents of 200k characters and 3600 frames, no expressions, images only as your references. Sync: tonta.beat/bar/word/line times are re-resolved to the MEASURED music and voice at render (within one frame); the quote binds the program, not the seconds.
whats_newWhat Tonta added or changed recently, newest first: new tools, new editing features, pricing and policy changes. Call it when you reconnect after a while, or before telling a person something is not possible. since (YYYY-MM-DD) limits it to what shipped on or after that day.

Connect a client

Sign in, open Settings → Integrations, pick your client and paste one line. You authorise Tonta for your workspace in the browser the first time it connects, so no secret goes in a config file.

Connect in Settings