Showoff.dev – AI Mockup Generator

Creates a cinematic, music-synced launch video for an app or web product in the style of the Showoff trailer: a 9:16 Reel (1080×1920, about 30–45 s), a 16:9 film for websites (format), or a 12–30 s teaser of one to three blocks without an end block. Use it whenever the user wants a launch video, Reel or teaser; use create_project for still images, App Store sets or a free-form animated film, and update_launch_video to change an existing video. Write the story first, then compose blocks in order (every block type is explained in blocks): a video always opens with a device, every move lands on the beat of the song, and the hero lands on the drop unless another block has on_drop. Transitions never cut or dissolve; leave them out for the natural ones. Lines are 2–4 words, written natively in the language of the video; the end card is the brand name slamming into its web address (merge_into). Without blocks you get the standard film from lines and tagline. Read the guide section "Launch videos" first. Screenshots go into named slots: pass URLs, or run the returned curl commands for files on disk. Returns the render page, where the video renders in the user's browser, and what is still missing.

Creates a new still-image or film mockup project in one call: devices arranged by a composition, reference shot or template, screenshots from URLs placed on their screens, a background palette derived from the screenshots, optional texts and extra edit_scene ops. Use it to start any image, App Store set or animated film; use create_launch_video for a music-synced launch video, duplicate_project for a variant of an existing project, and edit_scene to change a project that already exists. The result is reviewed before it is saved: if it has errors, nothing is created and you get the findings with fixes. Screenshots that are files on disk: create the project first, then run the returned curl commands. Returns project_id, editor_url, the media, the scene, the review and a preview sketch.

Deletes ONE project for good — with its history; it cannot be restored. Use it only when the user explicitly asks to delete this very project, never to tidy up on your own and never for several at once. confirm_name must be the project's exact current name (list_projects); otherwise nothing is deleted.

Copies a project (an image, a film or a launch video) into a new one next to it in the same folder, with everything in it: devices, screenshots, song, blocks. Use it for a variant the user wants beside the original, such as the same launch video to another song, another color, another language or a shorter cut; use create_project or create_launch_video for something new. The original stays untouched. Then change the copy with edit_scene or update_launch_video. Returns the new project_id and its editor or render link; pass that id to the next calls.

Changes a still or film project with a batch of ops: add, move or remove devices, put screenshots on screens, texts, background, camera, motion, highlights, store sets, rename. The batch is atomic: later ops see earlier ones, and either all apply or none. Use it for every change to an existing image or film project; use update_launch_video for a launch video and create_project to start a new one. Before saving, the result is reviewed: if an op introduces an error nothing is saved and you get the findings with ready-to-send fixes (dry_run only reviews). Someone with the project open sees the change live, and every save becomes a version (list_versions). After geometry changes the camera is re-framed and texts re-laid out unless keep_camera is true. Returns the review and a preview sketch. The full op catalog is in the description of ops.

Renders the finished mockup on the server with the real 3D renderer — models, materials, light, screens, background: exactly what the editor exports, no sketch lines. Returns the image to look at and a download URL (valid 7 days) you can hand on or process further. Takes 5–30 seconds. If the renderer is busy, it says so right away and nothing is charged; call it again after the time it names. Use render_preview for quick checks while building, this for the result. A store set (set_store_set) exports every image in every language as PNG in one ZIP, one folder per store and language (a few minutes; the whole set counts as one export). A set for phones exports both stores, App Store and Google Play. Width and format do not apply there.

Runs the strict final check before you hand the work to the user and tells you the next step. It passes only without errors; empty screens count as errors. Use it once at the end, after review_scene and render_preview look right; while building use review_scene. Read-only. When it passes: for an image or store set, call export_image next for the real render and a download link; for a film it returns the editor link, where the user exports the video (export_image only gives a still); for a launch video it returns the render page, where the video renders in the user's browser. When it fails, it lists the errors with fixes.

Reads the state of a launch video: its render page, the song with tempo, detected drops and the chosen section, every block numbered from 1 with its type, times and lines, and what is still missing. Use it before update_launch_video to get block indexes and slot names, and to replace screenshots; use render_preview to see frames, and get_scene only for still or film projects. Read-only. Returns render_url, the blocks, the music, ready, and a ready curl command for every screenshot slot and the song, including slots already filled (replace_commands): run those to swap a screenshot.

Reads the current scene of a still or film project: every object with its id, position and angles (cm and degrees), where it lands in the image (%), overlaps, the media on each screen, who changed it last, and the current art-direction review. Use it before edit_scene to get object ids and current values, or to see what a person changed in the editor; use render_preview to see the scene, review_scene for the full review, and get_launch_video for a launch video. Read-only. Returns scene, review, editor_url, open_in_editor and upload commands for empty screens.

Shows one template up close before you use it: what it shows, its public page, the full scene (devices with their angles, camera, background, overlaps), its review and a preview sketch with object ids. Use it after list_templates to check that a template fits the user's screenshots, then start a project from it with create_project (template_id). Read-only; it never creates or changes a project. Returns template, scene and review, plus the sketch unless preview is false.

For screenshots, screen recordings (MP4 or WebM, up to 25 MB and 120 s) and music that are files on your disk: returns a signed upload URL for this project (valid 30 minutes, no token needed) and the ready curl command. Run one command per file — in parallel — with ?assign_to=<device id> to put it on a screen at once. Much faster than base64.

Lists the building blocks for laying out a still or film scene: compositions (device arrangements derived from curated reference shots, with their device count and best formats), measured reference shots, background palettes, format presets, text roles and text regions. Use it before create_project or edit_scene to choose a composition, reference, palette or format; use list_templates instead when the user wants a finished, named scene, and suggest_palette for palettes matched to their screenshots. Read-only, no parameters. Returns a readable list plus compositions, references, palettes, formats, text_roles and text_regions.

Lists every device model Showoff renders (phones, tablets, laptops, displays, browser windows) with its id, size in cm, screen resolution and aspect, color variants and the screenshot size that fits its screen. Use it to pick a device id or variant for create_project, edit_scene (add_device, update_device) or create_launch_video, or to tell the user what size their screenshots should be. Read-only, no parameters. Returns one line per device and devices [{id, label, category, size_cm, screen_px, screen_aspect, recommended_screenshot_px, variants, browser_and_dock}].

Lists the folders of the user's Showoff projects as paths ("Showoff", "Showoff/Trailer"), each with its number of projects with and without subfolders, plus how many projects sit at the top level. Use it before filtering list_projects by folder, or before filing a project with the folder parameter of create_project, edit_scene, create_launch_video or update_launch_video, so you reuse an existing folder instead of inventing a new one. Read-only, no parameters. Returns folders [{path, projects, projects_with_subfolders}] and top_level_projects.

Lists the projects of the user's organization, most recently changed first, each with id, name, kind, devices, folder and its editor or render link. Use it to find the project_id the other tools need or to see what the user already made; use list_folders for the folder tree, and get_scene or get_launch_video to look inside one project. Filter by query, folder or kind; page with limit and offset. Read-only. Returns projects, the total number of matches and the offset, and says how to fetch the next page.

Lists Showoff's template catalog: finished, named scenes (stills and animations) such as "Low Hero" or "Desk Duo", each with a public page. Use it when the user wants ideas or a fast start: suggest two or three fitting templates by name with their page_url, then start one with create_project (template_id). Use get_template to inspect one first, and list_compositions to build a layout from scratch instead. Read-only. Returns templates [{id, name, kind, duration, width, height, devices, categories, description, page_url}].

The version history of a project, newest first: who changed it (a person in the editor, an AI, a restore) and when, and what changed. The same history the editor shows. Bring an earlier version back with restore_version.

Renders a fast schematic sketch of a project so you can check your work: exact perspective, geometry, screenshot placement, text and colors, without lighting or materials, optionally with object ids and review findings outlined. Use it after every create_project or edit_scene and inspect the image critically against the checklist in the guide (cut-off screen content, doubled status or menu bars, notch blocks, wrong orientation, collisions, text), then fix what you find; use export_image only for the final rendered image. Films: a contact sheet of frames (frames) or one frame at time. Launch videos: frames of the video itself, by default the key moment of every block, with its lines, a chat and the end card. Store sets: all images side by side, texts in language. Read-only; it never counts as an export. Returns the sketch image and a short summary.

Brings an earlier version of a project back (version_id from list_versions) — as a NEW current state, like Restore in the editor's history: nothing is lost, the state before stays in the history and can be restored in turn. The name stays as it is now. Someone with the project open sees it change live. Only when the user asks for an earlier version.

Runs the full art-direction review of a project: collisions (frame by frame for films), angles, floating versus resting devices, text overlap, cropping and contrast, composition and color. Use it while building to see every finding, including warnings edit_scene saves anyway; use finish once at the end for the final check, and render_preview to look at the result. Read-only. Every finding has a severity and a fix with ready-to-send edit_scene ops. Returns the findings, errors first, and whether the scene passes.

Suggests background palettes for a still or film project, derived from the accent color of its screenshots (or accent) and each already reviewed against this scene for contrast with the devices and texts. Use it once the screenshots are on the screens and before adding texts; list_compositions has the full fixed palette list. Read-only: apply one with edit_scene {op:"set_background", palette:""}. Returns the accent and palettes, best first, each with id, name, gradient, its review result and the ready-to-send op.

Changes an existing launch video. Use it for every edit to a launch video: replace the whole composition (blocks), change one block (block: { index, ...fields }, index from 1 as get_launch_video numbers the blocks), change the name, accent color, device, look, background or folder, add screenshots to slots by URL, or pick another part of the song (music_start, or music_drop for the exact drop) or a new song (music_url). Use get_launch_video first for block indexes and slots, create_launch_video for a new video and duplicate_project for a variant beside the original. lines/tagline without blocks rebuild the standard film. Another device re-checks the blocks: transitions that no longer fit fall back to the natural ones. Screenshots from disk: run the curl commands from get_launch_video (launch_screen=). Returns the updated video with its render page and what is still missing.

Adds an image from a public URL (or small base64) to the project's media library, analyzes its colors and aspect, and optionally puts it on a device screen. A song (MP3, M4A, WAV …) is analyzed for tempo and drops; in a launch video it becomes the music. For files on your own disk use get_upload_link instead — never pipe base64 through a shell into this tool, it is slow and gets cut off.