Skip to main content
Glama

Simpler.Asia

studio.suggest_social_clips

Find the best short-form moments in a long studio video and return them as ranges with a title, a hook line, a one-sentence rationale and measured evidence (captioned words, words per second, whether it starts on a scene cut). It creates and changes nothing. To make a suggestion into a project, call studio.create_social_clip with its start_ms and end_ms; then render that project with video.export_create and the same preset. Pass count (1 to 10), target_preset (default shorts_9x16; it sets the shape and the longest length, never over 60 s) and optionally asset_id to use only the scenes cut from one uploaded video. Costs up to about $0.0012 per call for the model; the wallet is checked first and an unfunded wallet gets PAYMENT_REQUIRED with nothing charged. Refuses, with nothing charged: a project with no finished footage (COLD_START: add footage with studio.add_scene_from_asset or studio.generate_scene), an asset_id that is not a video or not on the timeline yet (place it with studio.add_scene_from_asset), footage shorter than 5 s, read-only tokens and viewer roles. A pick outside the real footage is dropped with its reason in 'dropped', never stretched to fit.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
countNoHow many suggestions to return, 1 to 10 (default 3). Fewer can come back when the video has fewer distinct moments.
focusNoOptional: what to look for, such as 'the product demo'. It only ranks moments; it is never treated as an instruction.
asset_idNoOptional: suggest only from the scenes cut from this video asset (vas_...). studio.get_composition lists the assets; the asset must already be on the timeline (studio.add_scene_from_asset places it).
project_idYesThe studio project (vp_...) holding the long video. studio_project_list shows your projects.
target_presetNoThe export preset the shorts are for (default shorts_9x16). It sets the shape and the longest allowed length; pass the same preset to studio.create_social_clip and video.export_create.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources