ai.switchapp/switch

Prepare a private, short-lived download link for your own layers project: a ZIP holding every original transparent PNG plus a manifest of names, order, boxes and visibility, ready for Photoshop or Figma. Each call rebuilds the ZIP (one stored copy per project, overwritten).

Read or export the shot log of your Editor project (or one shared with you): format "json" (every field), "csv" (a sheet: shot number, timeline in/out, duration, source file, source in/out, description, shot size, angle, subjects, setting, action, objects, sound, suggested label, confidence, needs review, thumbnail), or "edl" (CMX 3600 for an NLE). Read only.

Pull one described sound out of your video, like "keyboard clicks", "camera shutter" or "page turning", and split it into single effects to hear, trim and save. Use the video already in the chat: put its file id or name in video_url; when it was sent earlier, not with the latest words, find it first among what was sent before. Never ask the person to send it again. Give the sound in a few words, and start_seconds and end_seconds when the person says where it is (leave them out to search the whole video). Priced at 1 token for each 10 seconds searched. It answers with a job_id: the clips come into the chat by themselves when done (about a minute). For where a job is, or to stop it, use sound_extraction_status with the job_id. The same request again answers the job already made and charges nothing. Clips are split where the sound goes quiet, which is a suggestion: music or speech under the sound can leave traces. When separation keeps too little of the sound (more than 10 dB under that part of the video) or fails, the clips are cut straight from the video's own sound instead: the answer says from "cut from the video", tell the person that anything else playing at that moment is in them too. A cut holds every sound in that part, one clip per sound, whatever words were asked: never ask again for other sounds in the same part, and give each clip its own name from where it sits. A failed separation is not charged.

Find the scene changes in a video of your Editor project (or one shared with you): the seconds in the file where the picture cuts, read by ffmpeg. Use them with edit_editor_timeline split_scenes (cut a placed clip at those points) or auto_clip (lay chosen pieces in a row). Also returns stills: the spans where the picture holds still; when you cut a screen recording or trim a piece out of a longer clip, cut inside a still span, never mid swipe or mid scroll. Free; a long file takes up to a few minutes.

Find licensed music tracks and sound effects in the Epidemic Sound catalogue, open to every account at no token cost. Search first: kind "music" (default) or "sound_effect" plus plain words for the moment; it returns sound_id, title, seconds and, for music, artists, bpm, moods and genres. To use one, call again with save_id (that sound_id) and the same kind: the high quality file is saved to your audio library and comes back with a generation_id (for add_sound_to_video or as a reference sound) and an audio_url. Use it for real music and real recorded effects; find_library_sound stays first for the small Switch Motion effects on the owner's account.

Find sound effects, music beds and ambience for your video in the Switch Motion Sound Library (952 level matched sounds: whooshes, swooshes, transitions, hits, chimes, UI clicks, typing, risers, glitches, logo stingers, ambient and music beds). Open on the Switch owner's account only for now (any other account is refused: make an effect with generate_sound_effect or a music bed with generate_music there). On the owner's account, use it before making any new sound effect: the library comes first and only a few effects go in a video, one per real moment. Returns the best matches with sound_id, description, length, seconds and an audio_url to use. Optional length: short (about 1 s), medium (1 to 2.5 s) or long; limit defaults to 5 (max 12).

Save the current arrangement of your own layers project as a finished picture in your library, composited at full quality from the original layer files. The project stays editable and you can flatten again.

See your finished Editor render at the seconds you name: one still per second comes back as a picture, in the order asked (20 per answer; any more come back named in still_to_look_at for the next call). Look at every moment its renderChecks flagged before you say anything about it. Free; nothing changes.

Generate spoken audio from text: narration, a voiceover, a read-aloud script, or a multi-voice dialogue. Pass text (up to 3000 chars) — the words to be spoken. To speak in one of YOUR saved voices, pass voice with the voice NAME (or id): users speak plain language and never know ids, so resolve the name yourself (the voice tool, action "list", shows every saved voice) and never ask the user for an id. Reference voices, trained clones and preset voices are all routed correctly by kind. To match a voice instantly from a clip instead, pass reference_audio_url (a short clip) or up to 3 reference_audio_urls and address them as @Audio1, @Audio2, @Audio3 in the text for dialogue. Alternatively pass image_url to voice a scene from a picture (cannot combine with reference audio). Pass delivery to direct HOW it should sound in plain English — the voice (gender, age, accent, emotion, tone, speed), the mic and room, and any background sound or music — e.g. "soft, warm and a little flirty, unhurried, close clear mic, no echo"; it works with any saved voice (trained clones included), with clips, or with no voice. To fix the length of a sentence, put a time window in front of it inside text, e.g. [5.5s:8.0s] before the sentence. Optional speech_rate (-50..100), pitch (-12..12), loudness (-50..100). Before writing a delivery line, a multi-voice scene or timed lines, call load_workflow_playbook with id playbook/audio-prompting: it holds the prompt order, the voice description fields, the @Audio tagging rules, timing control and the limits. Returns a playable audio_url, duration_seconds, and generation_id (also saved to your library). A longer line (roughly 20 seconds of speech or more) may instead return status "rendering" with a request_id: the take is still being made and is not lost — call get_audio_status with that request_id every 15 seconds until audio_url comes back, and never re-run the same line. To find an earlier take, call list_my_audio.

Make ONE audio file, saved to your library, of two or more people talking to each other, spoken by ElevenLabs v3 (or v4, with model). Give it lines in order, each with the voice who says it (a voice name or a voice id from list_voices) and the words. The speakers react to each other the way people in one room do, which is why this beats making each line on its own and stitching them. Inside any line's text you can write performance tags in square brackets and the model acts them instead of reading them out: [laughs], [laughs harder], [starts laughing], [wheezing], [whispers], [sighs], [exhales], [sarcastic], [curious], [excited], [crying], [snorts], [mischievously]. There are also sound tags such as [gunshot], [applause], [clapping] and [explosion], and experimental ones such as [sings] and [strong French accent]. Use ellipses and ordinary punctuation for pauses; there is no pause tag. As many lines as you like, up to 10 different voices, and up to 2000 characters of speech in total. Billed per 250 characters of everything said. For one person speaking use generate_speech.

Generate Switch images with one of seven models: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2.1 (Google's newest, up to 14 reference pictures), Nano Banana 2, Nano Banana Pro or Switch Vintage. Nothing older is offered or accepted. When model is omitted it auto-routes by subject: GPT Image 2.5 by default and for typography, screens and storyboards, Switch Pro for swimwear/beach, Switch Ultra for sexier content or face-fidelity work. The Nano Bananas and Switch Vintage are only used when named. Switch Vintage is a film look that works from a character taught beforehand, not from reference pictures. Counts <= 8 render inline in chat; counts > 8 queue to your Switch Studio with progress polling. All images persist to your Studio library and folder. Optional `style` (e.g. "wellness/warm_amber_tropical", "movie_scene/neon_noir_action") applies a curated photographic stack from the apply_* skill tools.

Make a music track with ElevenLabs Music: a song, a score, a background bed. Either describe the whole track in prompt (genre, mood, instruments, tempo, era, how it builds) or pass a plan you got from plan_music, edited however you like. seconds sets the length, 3 to 600 (default 30). For music under a video pass project_id (or video_seconds): the track is asked at the video's length, and if it comes back shorter the answer says how to loop it on a musical boundary; tell the creator and never leave the end silent. One take per ask: a second track minutes after the first needs another_take_reason with the creator's own words. instrumental true keeps every voice out. HOUSE RULE: only put music on a job when the customer actually asked for music; never add a bed because it feels empty, and when music is asked for keep it to what they named. This tool is NOT for sound effects: whooshes, impacts, chimes, risers, foley and ambiences are generate_sound_effect. Billed per 10 seconds (a token quote applies) and the file is saved to your library. Returns audio_url, duration_seconds and generation_id.

Make a music bed or one short sound hit for an edit (the beat-and-hits editor workflow), with no voice and no words. kind "bed" gives an instrumental bed of about `seconds` (4 to 60, default 15) to run under the piece; kind "hit" gives one sub-second sound to place on every cut. Pass description in plain words: the feel, tempo, instruments, texture. It is charged through the same audio generation as generate_audio (a token quote applies per second) and the file is saved to your library. Returns audio_url, duration_seconds and generation_id.

Make one sound effect from plain words with ElevenLabs SFX v3 (it follows several instructions in one prompt, for example "crowd cheering, then a ball drops, then booing", and handles vocal and musical sounds): whooshes, impacts, chimes, clicks, risers, ambiences, foley, anything that is not music and not a voice. Describe the sound (what it is, its attack and tail, its material, its feel), optionally fix its length in seconds (0.5 to 30; leave it out to let the model pick), set loop true for a seamless ambience, prompt_influence 0 to 1 for how literally to follow the words, model "v3" (default) or "v2" (ElevenLabs suggests comparing both on your own prompts), and output_format (mp3 at 32 to 192 kbps, opus, wav or pcm at 8 to 48 kHz, or ulaw/alaw 8 kHz for phone audio; default mp3_44100_128). For a music bed use generate_sound. Billed 1 token per 7 seconds of sound, rounded up (a token quote applies) and the file is saved to your library. Returns audio_url, duration_seconds and generation_id.

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). Every take speaks on Eleven v4 or Eleven v4 Turbo. Choose with quality: "fast" (the default, v4 Turbo, quick and cheap) or "best" (v4, the richest, most emotional read), or name one with model: v4 or turbo. v4 holds 10,000 letters a take and turbo has no stated limit. Both take stability and similarity (0 to 1) only. The price is checked before generation and the result includes its billing receipt. 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, Higgsfield Genjutsu, 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, except on a prompt the person wrote themselves (as_written) or one that is word for word a proven prompt from the owner's library: those go exactly as written, never enhanced; call enhance_video_prompt first to inspect it and reuse its signed enhancement_receipt. Use quote_video only to turn a draft into Full HD, passing its quote_fingerprint and quoted_credits; any other video runs without a quote and is charged what it really costs. 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. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p; Templates in the menu) 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. An id that was never started answers not_found; one that is still starting answers processing.

Where your export_editor_project export is: queued, rendering, complete (with the MP4 link and renderChecks: the finished file checked for black gaps, blank screens, frozen stretches, missing layers, dropped sound and the wrong length, each with its seconds) or failed (with the reason in plain words). Never hand over a complete export with open renderChecks without saying so. 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. A finished render carries renderChecks (black gaps, blank screens, frozen stretches, missing layers, dropped sound, each with its seconds); never hand it over with open findings without saying so.

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, plus the whole prompt (prompt_full) and every reference the video was made with (references: pictures, clips and sounds in their original order, each with its @tag, folder, file and a fresh url), so it can be made again exactly. 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. 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.

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 picture generations: queued batches and the pictures generate_image made right in the chat. Returns counts per status (pending / running / completed / failed) plus an array with id, status, prompts, model, ref counts, scheduledAt, finishedAt. Videos are in list_my_videos and audio takes in list_my_audio.

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. add_editor_library_assets) 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, its generation_id and made_with: the voice that spoke it (voice_name, voice_id), the model and the prompt. 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, and when each was made, so the newest can be found). Use this to find an existing folder and its id; search_my_library looks inside your library by words.

List your recent Switch videos, newest first: id, status, prompt, model, and a viewable view_url for finished clips. Use this when someone asks to see their last or recent videos, to check whether videos finished, and to let them choose one.

List the Switch Styles you can use for your edits, the short codes for editing a talking video (O Openers, W Words, F Frames, R Receipts, B Beats, U App Moments, K Kicks, M Motion Graphics, S Web, P Pace, A Audio, G Grade): each code with its group, name, one line, when to use it, the prompt line to paste and its demo clip links, plus the link to the style browser. Your own styles learned from your reels (codes like Y1) come first. Filter by group, by who is on camera, or by words. Free, read-only.

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, your reference voices (matched from a clip) included. 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.

Clean up and share your own saved voices (Seed Audio voices from a clip and trained voices), the same as the voice list in Audio Studio. action "delete" removes a voice for good (audio already made with it keeps its name); "turn_off" keeps it on the account but takes it out of every voice picker so it cannot speak; "turn_on" brings it back; "share" publishes it to the person's team so every teammate can see it and speak with it; "unshare" takes it back. Pass voice as the NAME you say (or its id); see your voices and which are on, off or shared with list_voices (mine_only true). Only the voice's owner can change it. Delete cannot be undone: say which voice will go and get a clear yes first. Free.

Keep your list of the questions you asked the creator and are still waiting on. Free. action "ask": record every question you are about to ask (questions: a list of { question, topic, choices? }; topic is one of music, voice, sound, shape, picture, video, style, choice); then ask them all at once. While a question is open, the paid steps it depends on are refused (music for music, voices for voice, sound effects for sound, pictures, clips and renders for shape, picture and video, everything that makes something for style and choice). action "answer": when the creator answers, pass question_id and creator_words, copied from their own message; you can never answer for them, and a reply that answers only part leaves the rest open, so ask again in one line. action "list": what is still open.

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: a list of parts in order (chunks on the newest music model, sections on the older one), each with its words or name, a length in milliseconds and its own styles to keep in and keep out. 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. First call premiere_list_connections to get the deviceId of your connected Premiere panel.

Read an edit outcome. Only done means Premiere reported verified readback; cancelled requests already running may finish. First call premiere_list_connections to get the deviceId of your connected Premiere panel.