switch

Speak written words out loud in an ElevenLabs voice and save the audio to your library. Give it the words and the voice (a voice name, or a voice id from list_voices). Choose the model with quality: "fast" (the default, quick and cheap) or "best" (the richest, most emotional read), or name one yourself with model: v4, turbo, v3, conversational, multilingual or flash. How much text one take holds is set by the model you pick: v4 and multilingual 10,000 letters, v3 5,000, flash 40,000, and turbo has no stated limit. You can set stability and similarity (0 to 1) on every model, and style, speed (0.7 to 1.2) and speaker_boost on every model except v4 and v4 turbo, which take stability and similarity only. Billed per 250 characters of text, so a 500-character script costs two units. The answer carries the time in seconds that every single word starts and ends, which is what you use to cut on the beat, place captions or time a picture to a word. For a sound effect use generate_sound_effect; for two or more people talking in one file use generate_dialogue.

Generate video with the configured provider lineup (Kling, BytePlus Seedance, Switch Video/WAN 2.7, Switch Video Edit, Switch Cinema, Topaz upscale) and modes (text-to-video, image-to-video, frame-to-frame, motion, omni, reference-to-video, video-edit, upscale). Load load_video_workflow once per conversation when needed. Keep the user-selected model; use list_video_models only when the selection or its inputs are unknown. SwitchApp Video Enhanced runs automatically before submission; call enhance_video_prompt first to inspect it and reuse its signed enhancement_receipt. Use quote_video for the exact current token price and pass quote_fingerprint plus quoted_credits to enforce it. Before submission, map every actual image, video, and audio chip to its role and preserve its thumbnail, type, order, and role exactly; never silently drop, merge, reorder, convert, or repurpose references. Pass one shot, or shots:[...] for a storyboard (max 4 by default, hard max 10) where EACH shot is DIFFERENT — never repeat one prompt to get copies. Renders async (~30-90s); a background job delivers each clip to your library. Returns a task_id per shot — poll get_video_status or list_my_videos. Switch Cinema (switch-cinema-480p / switch-cinema-720p) remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls and keeps the clip's motion; no duration, priced per second of that clip, subject optional and sent as typed.

Collect one of your finished audio takes. When generate_audio answers status "rendering" with a request_id (a longer line), call this with that request_id every 15 seconds until it returns status "done" with a playable audio_url, duration_seconds and generation_id. Also fetches any earlier take by its generation_id. Never re-run the line while it is rendering.

Read your brand kit before you design, animate or write anything for your brand: its colors with their roles, its fonts (with a link to the font file when one was uploaded), light or dark as the usual look, how the brand sounds, and links to its logos and pictures ready to use. With no name it reads your default kit. When you have no kit it says so and how to make one; then keep the work brand neutral. Free and read only.

Check one of your depth map renders started with create_depth_map. Pass the task_id it returned. While rendering it reports processing; when finished it returns depth_video_url, a download link for the grayscale motion reference video. If the render failed, it says so and confirms your tokens were returned.

Where your export_editor_project export is: queued, rendering, complete (with the MP4 link) or failed (with the reason in plain words). Free. Not only a read: when one render pass of a long export has finished and more remain, this call starts the next pass of the export you already started (no new charge).

Inspect one of your persistent Switch Editor projects. Omit project_id for your latest project; include_payload=true returns its full editable state.

Read progress, checks, exact approval quote, revision, and render result for one of your Switch Editor agent runs.

Open one of your own layers projects: every layer with its name, description, stacking order, whether it is showing, and where it sits on the picture. Use this before arranging layers so you know their ids.

Read your staged references in Switch Studio. Returns TWO groups: (1) the image-generation reference strip (typed face/body/outfit/scenery/product slots) under `refs`, and (2) the VIDEO-tab references the user staged in the Omni/Image video tabs (the @Image1/@Image2 strip) under `videoReferences`, with usable signed URLs. Call this before generate_image or generate_video whenever the user says "use my refs" or refers to images they staged in Studio (including "the images in my video tab"). To make a video from the video-tab refs, pass videoReferences.imageUrls into generate_video reference_image_urls (and videoUrls into reference_video_urls) in reference-to-video / omni mode. Refs marked alive:false are dead (stored file gone) and are already excluded from the usable url lists. NOTE: a photo the user just attached in THIS chat is in neither group — for that, call upload_media and use its returned url/asset id directly.

Check the status of one of your video jobs by task_id (from generate_video) or job_id. Returns status, a viewable view_url when finished, or the error if it failed. Poll this every ~20s — do not loop rapidly.

Fetch one of your finished Video Analysis reports by report_id (from analyze_video_report or list_vision_reports). Returns the complete structured report: overview scores and takeaways, the timeline of scenes, audio, visual, story, speech, the recreation section with every master prompt, and metadata, plus recreation_prompt (the ready to run prompt) at the top level. While an analysis is still running this reports processing; poll it every 20 to 30 seconds.

Pull the voice out of a noisy recording with the ElevenLabs voice isolator. Traffic, room echo, air conditioning, crowd, hiss and any music behind the speaker all come off and the speech stays, so a phone recording or a noisy location take can be used as clean dialogue. Pass the recording as source: an id from your library or a public https link. Nothing is added back, so the answer has no room and no music at all. Billed per 10 seconds of audio (a token quote applies) and the clean file is saved to your library. Returns audio_url, duration_seconds and generation_id.

Lip-sync audio onto one of your videos. For action="create" without engine, session_id, or face_id, the default is Sync Labs Sync 3: video_url + sound_file (base64 data URI) processes the whole clip without a face-identification step or manual timing. engine="best" explicitly selects Sync 3. Kling provides manual timing control with engine="kling", or with session_id/face_id when engine is omitted: (1) action="identify-face" with video_url (MP4/MOV, 2-60s, <=100MB, 720p/1080p); (2) action="create" with session_id + face_id + audio + timing IN MILLISECONDS (sound_start_time, sound_end_time, sound_insert_time) + optional speech_volume/original_audio_volume (0-100); (3) action="status" with the task_id to poll — returns a branded SwitchApp view_url when done. Charges credits on create; failed jobs are refunded.

List your brand kits: each one with its name, whether it is your default, light or dark, its colors and fonts, and how many logos and pictures it holds. Use get_brand_kit to open one. Free and read only.

List your persistent Switch Editor projects, newest first, with media, scene, composition and render counts. Optional search matches the project name. Each project carries its own media and its saved chat history for every brain; the same project opens in the /editor page.

List the named editor workflows your Switch Editor agent can run by id: for each, the one sentence a person types, what it needs, whether it quotes first, and how to run it on your project through run_editor_agent. Pass id to read one workflow in full with its steps, tools and gate. Free and read-only.

List your recent and active generation tasks. Returns counts per status (pending / running / completed / failed) plus an array of your tasks with id, status, prompts, model, ref counts, scheduledAt, finishedAt.

Return your asset METADATA only (id, truncated prompt, model, created date), newest first. This does NOT display images and must NOT be used to show pictures — if the user says "show me / display my last image(s)", call show_media instead (it renders them; pass count=N for several). Use list_my_assets only when you need ids/metadata for another tool (e.g. move_asset) or a plain text list.

List your recent audio takes (voice lines, narration, dialogue) newest first, each with a playable audio_url, duration_seconds, the words spoken and its generation_id. Use it to find "the take from earlier" or "the newest line" without asking the user for ids. Optional search matches the words spoken; limit defaults to 5 (max 20).

List the folders in your Switch library (id, name, parent). Use this to find an existing folder before move_asset or create_folder.

List your recent Switch videos, newest first — id, status, prompt, model, and a viewable view_url for finished clips. Use this to check whether videos finished and to let the user choose which one they want.

List the video upscalers you can run on your videos, their provider routes, supported controls, and release availability. Uses the same catalog as Video on desktop and mobile. Does not start a job or spend tokens.

List the video providers, models, and modes available to your Switch account, with each model's required inputs, allowed aspect ratios and durations, and a rough per-second cost. Use this when the selected model or its required inputs are unknown. Keep a known selected model; do not run model searches for an ideas question. Use quote_video for a current exact token quote.

List your Video Analysis history, newest first: report_id, date, status, source kind, duration, engine, tokens charged, and each report's headline. Use it to find a past analysis, then pass its report_id to get_vision_report (full report) or video_to_prompt (just the recreation prompt).

List the voices available to speak with: the ready-made library voices plus every voice this account has cloned or designed. Each one comes back with its voice_id (pass that to the speaking tools), its name, whether it is ready-made or one of your own, labels saying who it sounds like (gender, age, accent, what it suits) and a preview_url that plays a short sample. Optional search matches a name or a description, for example "warm female narrator" or "deep british male". Set mine_only true to see only the voices you made yourself. count defaults to 30 (max 100). Free and read only.

Load once when starting production on your video and the workflow is not already known. Not needed for an ideas question. Loads the current MCP-only production rules, BytePlus Seedance routing policy, exact reference-chip preservation rules, simple-remix rules, conditional analysis and Depth Maps, enhancement, exact token quote, audio preservation, KYC behavior, and completion standard. Free and read-only.

Load one shared production playbook by id (ids come from load_video_workflow) and apply it to your production. A playbook is an anonymized record of how a real Switch production went: the shot list that worked, the reference rules, and the corrections that had to be made. Free, read-only.

Log the shots of your Editor project (or one shared with you) after the customer said go to the quoted price: numbers every clip on the video track (SH001 …) with timeline and source in/out, then Gemini watches each shot (charged per shot: 3 tokens a second, 90 at least) and writes its description, shot size, angle, subjects, setting, action, objects, sound and a suggested label onto the Storyboard card. Works through the list within one call; when done is false, call again to carry on.

Put a finished video on your Switch Editor project's timeline from its https link (an InVideo export, a Switch render, any video you own). It lands at the end of the timeline and in the project's media, ready to play and export. Spends no tokens.

Draft the plan for a music track before any of it is made, and before anything is charged. Describe the track you want for your edit and this returns the structure the music maker intends to build: the overall styles to keep in, the styles to keep out, and a list of sections with a name, a length and its own styles and lines. Edit whatever you like in that plan, then pass the whole thing to generate_music as plan to hear it. Use this for longer or structured pieces (intro, verse, chorus, drop, outro) where a single sentence will not get the shape right. Free: this call does not make audio and does not cost tokens.

Cancel a pending Premiere edit. An Adobe transaction already running may finish. Read its final status.

Read an edit outcome. Only done means Premiere reported verified readback; cancelled requests already running may finish.

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.

List your authorized Premiere connections. 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.

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), or compatibility English text, to your approved Premiere sequence. 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, renamemedia, renamebin, removeitem, smartbin, metadata, newsequence, subsequence, deletesequence, opensequence, closesequence, sequencemarks, zeropoint, settings, playhead, workarea, saveas, openproject, closeproject, importsequences, importae, newproject, preference, ingest, scratch, monitor, clone (a copy of a clip at an offset on another track), mogrt (a template from a Creative Cloud library), override, encodefile, launchencoder, xmp, purgecache, growing, metadatafield, panelmetadata, property, mediastart, inspect (a read: markers, effects, transitions, settings, metadata, workarea, playhead, app, keyframes, transcript, interpretation, media, clip, sequences, selection, panel, columns, property, c2pa, masks, language, production, tracks, monitor, colour, find, bin, captions, nearest; the answer comes back as the receipt). Files are named next to the project, never as paths. The transcribe receipt lists the spoken lines with their seconds. Tick strings must align to sequence frames; tracks are zero based. Imports require the local file picker. Supply the revision and target from a timeline read. Use the same requestId for retries. Queued does not mean edited.

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.

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. 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. Free. Call it before and after edit_editor_timeline so you know the indexes and ids.

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.

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.

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 task id — prompts, model, ref counts, saved/failed counts, ETA hint, asset ids.

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.)

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. 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.