ai.switchapp/switch

See one frame of the sequence your Premiere panel shares, at a given second. The panel exports the frame itself (nothing in the project changes) and the picture comes back here as an image plus its address in your library space. Takes a few seconds; the panel must be open and connected. First call premiere_list_connections to get the deviceId of your connected Premiere panel.

List your authorized Premiere connections. Call this first: each connection carries the deviceId every other Premiere tool needs. No footage is uploaded.

Read the sequence shared by your Premiere panel, including names, timing and a revision. Inspect readAt for freshness. No footage bytes. First call premiere_list_connections to get the deviceId of your connected Premiere panel.

Before planning motion, load playbook/motion-design (timing, easing, choreography, depth, sound). Send one typed edit operation, a list of 1 to 20 operations (one batch: one Undo in Premiere when every kind is one transaction; with overwrite, split, save, import, export or fetch inside it runs in order, each edit its own Undo step, and stops at the first that fails, saying what is done), or English text, to your approved Premiere sequence. Text reaches only the fixed examples in the panel, with no model behind it: read timeline, duplicate sequence, save project, create bin "name", import media into "bin", move media "x" to "bin", insert "x" at T on Vn An, add audio "x" at T on An, trim Vn:n end to T, move Vn:n to T; any other text is refused with the typed operation to send, so send everything else as a typed operation (a new empty sequence is newsequence, then settings for size and frame rate). When the connection reports alwaysAllow true the edit runs on arrival; otherwise it waits for a press in the panel. Several requests may queue. The whole Adobe surface is typed (docs/premiere/OPERATIONS.md has one row per kind with the Adobe call behind it). Cutting kinds take picture (V) or sound (A) clip keys. Kinds: duplicate, save, bin, import, organize, insert, audio, overwrite (a library item laid over the timeline at a point, replacing what is under it), trim, head, split, remove, enable, rename, move, clipmarks, marker, markeredit, markermove, markerremove, effect, effectat, effectremove, audioeffect, keyframe, unkeyframe, animate, transition, untransition, transcribe, importtranscript, scenecut, select, track, export, encode, batch, aaf, fcpxml, otio, fetch (one of your Switch videos or images by id lands next to the project and, with at plus video and audio tracks, on the timeline; no file picker), caption (text on screen above a clip as a motion graphics template), sourcemarks, subclip, label, interpret, lut, scaletoframe, relink, proxy, offline, refresh, renamem…

Build the numbered V1 shot log (SH001, SH002…) from the sequence your Premiere panel shares: timeline in and out, source in and out, duration (timecode and exact ticks), source file, clip reference, and, once Describe shots has run in the panel, each shot's description, size and notes. Returns rows and a CSV with the brief's columns. No footage bytes. First call premiere_list_connections to get the deviceId of your connected Premiere panel.

Say what it costs to log the shots of your Editor project (or one shared with you): every clip on the video track becomes SH001, SH002 … with its timeline and source in/out, and Gemini watches each one for a short editorial description, shot size, angle, subjects, setting, action, objects and sound. Nothing is charged by this call.

Get the current server price in Switch tokens before video generation. Uses the same billing calculator as submission and measures your stored reference clips. Pass one shot using the same model, mode, duration, resolution and references as generate_video. No creative prompt is required for a quote. Does not enhance, generate, or deduct tokens: quoted_credits and would_deduct_credits are prices, and charged is always false. Upload external video/audio references first. Returns quote_fingerprint for generate_video; a changed price is rejected before charging. Some routes may return QUOTE_ROUTE_UNAVAILABLE instead of inventing a price.

Read the timeline of your Editor project (or one shared with you) track by track: every clip with its index, label, start, end, length, in and out points in its file, link, speed, volume and fades; the project's media (ids and names to place), its text layers, its colour look, the motion blocks and film stocks that exist; and check, the things to look at before an export (a clip playing past the end of its file, a clip with no file or no length, clips overlapping on a track, a mix that could clip, words running past the video, black gaps, unused media), each with its second and clip. Also every timeline tab of the project (id, name, open or not, length) and the project's shape. The media list only with include_media true; readback summary gives track lengths and clip counts only. Fix every warning in check before you say the edit is done. The loudness note (mix.peak) is a worst-case guess the export limiter already holds at -1 dB: report it and leave it to the creator. Free. Call it before and after edit_editor_timeline so you know the indexes and ids.

Rename one of your folders (its id from list_my_folders). Only your own folders. Free.

Render your current persistent Switch Editor project as an MP4 through the Switch render service. Use get_editor_run to follow it to playback and download; the finished render carries renderChecks (black gaps, blank screens, frozen stretches, missing layers, dropped sound, with seconds). Look at it with contact_sheet and frame_at, and never hand it over with open findings without saying so. timeline renders one timeline tab by name or id (that tab becomes the open one); default the open tab. PRICE: A render runs as a short Editor job. Priced per step: each step the Editor agent takes costs the same tokens, charged just before the step. How many steps a job takes depends on the job, and every charge shows in get_editor_run as it happens. Things it makes along the way (a picture, a clip, a voice) cost their own price on top, and some of them wait for your yes with approve_editor_run. Pass quote_only: true first to get the exact price; nothing is made and nothing is charged. To run it (not for a quote) send project_id.

Tell your Switch Editor agent to build or revise the persistent editable project. It can author scenes, layers, variables, files, motion, and narration plans through the real HyperFrames project workspace. Pass workflow to run one of the eleven named editor workflows by id (proof-open, voice-narration, screen-record, real-tray-assets, prompt-breakdown-card, word-captions, beat-and-hits, hard-cut-pacing, credit-card, one-word-cta, long-form-retention-cut for a podcast or talking head into a finished vertical clip); the prompt then carries the creator's specifics and may be omitted to use the workflow's own sentence. PRICE: Priced per step: each step the Editor agent takes costs the same tokens, charged just before the step. How many steps a job takes depends on the job, and every charge shows in get_editor_run as it happens. Things it makes along the way (a picture, a clip, a voice) cost their own price on top, and some of them wait for your yes with approve_editor_run. Pass quote_only: true first to get the exact price; nothing is made and nothing is charged. To run it (not for a quote) send project_id.

Save your brand kit, or change one you already have: the brand's name, its colors, its fonts, light or dark as the usual look, a few words on how the brand sounds, a folder in your library, and its logos and pictures. Logos and pictures are pictures from your own Switch library, passed by their asset ids from list_my_assets or search_my_library; a file the person has not added yet goes in first with upload_media, then its returned asset id goes here. Saving with the name of a kit you already have updates that kit, and only the parts you pass change (a list you pass replaces that list). Your first kit becomes your default. Up to 24 colors, 12 fonts, 12 logos and 60 pictures per kit. Free.

Search your library by prompt substring (metadata only — id, prompt, date). Optional folderId scopes to one folder. Only your own assets are returned. This does NOT display images; to show/display results to the user, pass their ids to show_media.

Share one of your Switch Editor projects with a team member by their Switch account email, stop sharing it, or list who has it. A shared project opens for them with its media, its chat history and its renders; they can edit, upload, run the editor brains and render. Only the project's owner can share or delete it. Actions: list (default), share, unshare. Share only when the person named the email and said to share.

Get the full detail of one of your generations by its id — prompts, model, ref counts, saved/failed counts, ETA hint, asset ids. Also takes a video task or job id (from generate_video) and an audio generation_id or request_id, and answers with that job's status and links.

Display the user's images inline — one or many. Users speak plainly and will NOT know asset ids; never ask for one, resolve it yourself. For "show me" or "show me my last image" call with NO arguments (shows the most recent image). For "show me my last 4 images / my last 10 pictures" pass count=N (returns a clean grid, up to 12). For a specific known image pass assetId. Renders a branded SwitchApp media card with a Download action per result; do not just print URLs. (Videos are not shown here — use list_my_videos and return the newest finished video's view_url, which plays.)

Where your sound extraction from extract_sound_effect is, by its job_id: still separating, done with its clips (name, link, where each sits in the video), stopped or failed. Reading it also finishes a job that has completed, so it is safe to call again after the person comes back. action "cancel" stops it: before it ran the tokens come back; once running it may still finish and is charged. Free.

What your calls cost: every charge on this account over the last `hours` (default 24), newest first, each with what it was for, the model, the tokens it was worth, the tokens actually taken, and the dollar value at Switch retail; plus totals, the current token balance, and what a token is worth. Use this to itemize Seed Audio, Sync 3 lip-sync, generate_sound and every video or picture call. For just how many tokens are left, use check_balance. Free to call.

Separate one of your own Switch images into editable layers with Seedream 5.0 Pro: a base plus up to 16 transparent PNG layers, each named and placed. Say which image (asset_id, or "my last image"), optionally what to separate, and the size. Charged only for the layers that actually come back; a failed split is fully refunded.

Stitch your videos together in the Switch Editor: puts the given videos on a fresh Editor timeline in the order given and returns the Editor address, where the cut plays in the preview and Export renders it as one video. Use this when the user wants to join, stitch, combine or put clips back to back and keep editing. Pass video ids in play order (from list_my_videos). Spends no tokens; stitch_videos is the one that renders a file straight away.

Stitch several of your Switch videos together into ONE video, played back-to-back in the order you give. Pass clip_asset_ids: an ORDERED list of your video ids (get them from list_my_videos) — the first id plays first. Optional orientation (landscape|portrait|square), fps, quality. Renders the combined video with ffmpeg and returns the finished, downloadable video url right away (also saved to list_my_videos). Use this whenever the user wants to combine, join, merge, or concatenate multiple clips into one.

How many seconds a video clip should be for a spoken line, so the words are never rushed or dragged. Give it the spoken text (or a word_count) and it returns a suggested duration for four delivery energies: slow and dramatic, natural, upbeat, and super charismatic talking-with-your-hands. Fewer seconds is a faster more excited delivery; more seconds is slower and more dramatic. Deterministic, free, no charge. Use it whenever a user asks how long to make a clip for their narration or dialogue, or which duration to pick for a given energy.

Main SwitchApp lip-sync for your videos. Uses Sync Labs Sync 3 only — never Kling. Call action="create" with video_url plus either sound_file (a base64 audio data URI) or audio_url; then call action="status" with the returned task_id. Sync 3 processes the whole clip in one pass with occlusion-aware lip sync, preserves the supplied audio, and returns a branded SwitchApp view_url when complete. Charges credits on create; failed jobs are refunded. PRICE: One price per lip sync job, charged when the job is created; returned if it fails. Checking status is free. Pass quote_only: true first to get the exact price; nothing is made and nothing is charged. To run it (not for a quote) send action.

Turn a face photo into a lip-synced talking-head video that speaks your text (or your audio). Provide image_url (a clear face photo) and either script (text to speak, max 2500 characters) or audio_url. Optional voice_id / language / voice_settings. Renders in ~1-5 minutes (single call, returns the finished branded video) and is saved to your library. PRICE: Priced per second of the speech (your audio, or the script once spoken; a part second counts as a whole one), charged when the speech is ready and before the video is made, and returned if it fails. Pass seconds with quote_only for a total (suggest_speech_seconds tells you how long a script runs). Pass quote_only: true first to get the exact price; nothing is made and nothing is charged. To run it (not for a quote) send image_url.

Write out everything said in a recording, with the exact second every word starts and ends. Give it the asset id of a clip in your library (or an https link) and you get back the full text, the language it heard, and a word-by-word list with times you can build captions or cut on. Set speakers true when more than one person is talking and each word is also labelled with who said it. Set sound_events true to have laughter, applause and other noises marked too. Pass keyterms, a list of words or short phrases (up to 1000, each under 50 letters and 5 words or fewer), to make sure names, product words and acronyms come out spelled the way you write them, for example ["QA"] so it is not heard as "Q&A". Works on audio and on video files. Billed per minute of the recording (a charge applies). Nothing new is saved to your library.

Arrange your own layers project: show or hide a layer, move or resize it (box as [left, top, right, bottom] in the base picture's pixels), change its stacking order, or reset it back to where the split put it. Saves immediately through the same checks the Switch workspace uses, so the app shows the same thing.

Put image, video or audio files into your real Switch Editor project. By default they land in the project's media bin only; pass place: true to also lay each one at the end of its track. Three ways: url (an https link to the file; Switch keeps a copy), video_id (one of your finished videos from list_my_videos, attached as it is), or bytes: call with presign=true (one file, or files: [...] for several), PUT each file to its upload_url within 2 hours (or use the resumable block, a TUS upload in 6 MB pieces that can resume for up to 24 hours, for a big file on a slow link), then call again with confirm: [the confirm objects from the presign answer] (several in one call; each keeps the place asked at presign) or confirm_path for one. Files up to 500 MB each. A video's scrub copy and frame strip are made in the background after the confirm (a long clip takes a few minutes; the original plays until they land).

Kept for apps that already use it; new work uses upload_reference_asset. Same checks either way: a picture of a real person's face is protected automatically when it is used. Upload one image into your Switch library in a single call. Pass `url` (any public https) OR `base64` + `mime`. Switch fetches/decodes it server-side, stores it, and returns a clean public URL plus the new asset id. This is THE way to use a photo the user attached in chat as a reference: pass the returned `url` directly into generate_image's reference_image_urls, OR into generate_video's image_url (image-to-video) or reference_image_urls (reference / omni video). The returned URL is provider-fetchable as-is — no presigned PUT, no curl, no confirm-upload step. Do NOT call get_my_active_references for a chat-attached photo; that strip only holds Studio-managed refs.

THE upload door for references. Upload an image, video, or audio reference into your Switch cloud and get an opaque asset_id (never a raw storage URL) to pass in reference fields. Pictures of real people need nothing extra: Switch checks every picture when it is used and sends a face through the protected face path automatically, in its own place. First inspect the asset and record what its actual chip controls. Preserve its thumbnail, media type, order, and role; uploading never authorizes replacing the visual chip with text or silently dropping, merging, reordering, converting, or repurposing it. A clear speaking and moving video is usually strongest for realistic identity, performance, motion, and voice when supported; still images sharpen appearance, wardrobe, products, logos, typography, and scenes. Pass kind=image|video|audio. Returns reference_image_urls / reference_video_urls / reference_audio_urls for generate_image and generate_video. Uploads stay separate from active Studio references by default, including images uploaded for video work. Set activate=true only when the user explicitly asks to add this image to the Studio image workspace. Video and audio never touch the Studio strip. PREFERRED for real files: call with presign=true to get an upload_url, PUT the bytes straight to it (no base64 through the model), then call again with confirm_path to verify and record it — works for image, video, and audio. base64/url is only for tiny inline files.

Upscale and enhance one of YOUR videos (or a public https clip) with Topaz. Full control: scale 1 to 4 (1.5x works), optional target_fps 16 to 60 where the selected model supports it, and the Topaz model (Proteus default; Artemis, Nyx, Gaia and Starlight families available). Batch up to 10 clips per call via videos: [...]. Use list_upscalers first for model availability; unreleased models cannot start through MCP or API. Each entry accepts a Switch job id from list_my_videos, its download_url or view_url, or a public https URL. Use quote_only for exact Switch token prices. Confirm quoted tokens and fingerprint using confirmed_quotes. Keep request_id across retries. Renders async; poll get_video_status per task_id.

Write a soundtrack for a video from the video itself, with ElevenLabs Video to Music: it watches the cuts, pace and mood and scores them. Use it when the customer asks for music made for their video ("write a soundtrack for this", "score my clip"). When they bring their own song (for example from Suno), use that song instead and do not call this. Pass the video in video_url (the file id or name from this chat, or an https link), or video_id for a video made in Switch (its job id from list_my_videos; up to 10 videos in video_urls, all together up to 200 MB and 10 minutes). Optional: description (the music in words, up to 4100 characters), tags (up to 10 styles, like "cinematic", "lofi"), add_sound_effects (sound effect cues from the picture), use_video_sound_as_reference (its genre, tempo, instruments, mood and arc from the video's own sound), separate_tracks (the music and the effects as two files), video_seconds (the video's length, for the hold). HOUSE RULE: only make music when the customer asked for music. Billed like generate_music, per 10 seconds of the track (a token quote applies). Returns audio_url, duration_seconds and generation_id, and effects_track with separate_tracks. It does not put the music on the video: add_sound_to_video or the Editor does that.

Turn one of your finished Video Analysis reports into ONE reusable generation prompt that recreates the source video's look, energy, pacing and mood, with a {your photo} placeholder where your own subject goes. Pass report_id (from analyze_video_report or list_vision_reports) or video_url (the exact source URL you already analyzed). Free: it rewrites the analysis you already paid for and never charges. If the video has not been analyzed yet, run analyze_video_report first. Optional focus: pass mode to control what the prompt describes, and engine to pick the model format — also free.

Your saved voices — one tool for the whole voice library. Users speak plain language and never know ids: resolve every voice by NAME yourself (call action "list" first if unsure) and never ask the user for an id. action="list" returns every saved voice with voice_id, name, kind and ready — kind "reference" is an instant voice match saved from a clip and kind "clone" is a trained voice (both speak through generate_audio: pass the NAME as its voice param, and load_workflow_playbook playbook/audio-prompting says how to direct the delivery). action="create" saves a NEW reference voice from a clip: voice_name plus audio_url (e.g. the url upload_media returned) or audio_base64 (+ format) — free, ready instantly. action="clone" TRAINS a real clone (the closest match to the real person): voice_name plus audio_sample_url or audio_base64 (+ format), a clean 10-15 second clip of one person talking, optional language. Charged, uses one of the account's training slots, may take a minute — returns ready true/false; list again until ready. action="rename" renames a saved voice (voice_id takes the id OR the current name, new_name is the new name). action="delete" removes a voice by voice_id or name.