Workflows and music videos
Use these tools to run workflows and to cut a video to a music track.
Workflows over MCP
Section titled “Workflows over MCP”Not every account has these tools. You build your own workflows in the Screel editor, and Screel ships built-in templates. These tools find both, run them, follow the run and answer the steps that pause for a person. They do not change a workflow’s steps.
On ChatGPT app v2, a run reads only files Screel already stores. A picture, video or audio input there takes the id of a file Screel holds, or a link that Screel returned. A workflow with a step that fetches from the web does not start there: run it from the Screel editor.
list_workflows
Section titled “list_workflows”The workflows of a project, or of your personal library when no project is named. Each one comes with its Run form: the param steps with their name, kind, default and options. A param can also carry show_when, the input value that shows it, and advanced, which folds it under More options in the editor. Also lists the built-in templates under templates. Each template has its key, title, description, what it makes, its number of checks, its stages and its Run form. It spends no credits.
- Surfaces: ChatGPT app v2, Generic MCP, Manan
- Parameters:
project_id
run_workflow
Section titled “run_workflow”Start a run with the Run form values and a credit budget; without a budget the run gets the default one. Name one of your workflows with document_id, or a built-in template with template and a project. The keys lyric-video and performance-video name the Music video template with its Kind set to Lyrics on screen or Performer sings. The first run puts the template into the project as a workflow, and later runs reuse that copy, edits included. A library workflow run with a project runs as a copy in that project. On Generic MCP, a picture, video or audio input takes a public https link or the id of a file Screel holds. Screel stores a linked file in your project first. A budget below the run’s estimate starts nothing, and a run that reaches its budget pauses instead of going over. It returns the run’s job_id at once, and the run continues in the background. It spends credits up to the budget.
- Surfaces: ChatGPT app v2, Generic MCP, Manan
- Parameters:
budget_credits,document_id,params,project_id,request_id,template
get_workflow_run
Section titled “get_workflow_run”One run’s status, outcome, credits and budget, and every step’s label, status, error and a short summary of its output. A failed run and a failed step carry an error_code. A paused step also lists its pause_kind, its question, its options and its candidates, each with the index a choice takes. It lists at most 12 candidates, and candidates_total counts them all. An agent step’s question can also list suggestions, short answers the agent proposes, and question_read, one line on what it concluded; any other answer stays valid. It spends no credits.
- Surfaces: ChatGPT app v2, Generic MCP, Manan
- Parameters:
job_id(required)
resolve_workflow_node
Section titled “resolve_workflow_node”Answer a paused step: pick one of its options or one candidate, pass every candidate on, or answer its question. A run paused at its budget continues only in the Screel editor. The tool spends no credits, and the steps after it spend within the run’s budget.
- Surfaces: ChatGPT app v2, Generic MCP, Manan
- Parameters:
job_id(required),node_id(required),answer,choice
Music videos
Section titled “Music videos”These tools cut a video to the project’s music track. The scenes change on the beats, and the track plays as the soundtrack. On ChatGPT app v2, the song comes from generate_music, or from your own track through set_music. In Manan, attach the track to your message and ask for a music video.
analyze_audio
Section titled “analyze_audio”Read a music track for a video cut to the music: its tempo, beats, sections and timed lyric lines. Each section reports its energy and whether a voice sings. Every time is in seconds of track time. With no track named, the tool reads the project’s music track. It also takes the id of an audio file Screel holds. On Generic MCP and in Manan, it takes a public https link (audio_url), and Screel stores the file in your project first.
Pass the lyrics when you know them, and Screel times the lines instead of writing them down from the vocals. Screel keeps the analysis with the track, so a second read answers at once and spends nothing. plan_music_cuts and a workflow’s Music cuts step read the same analysis. A new analysis returns a job_id, and get_job_status carries the analysis when the job finishes.
A new analysis spends credits, and a repeat is free.
- Surfaces: ChatGPT app v2, Generic MCP, Manan
- Parameters:
project_id(required),audio_url,lyrics,request_id,resource_id
plan_music_cuts
Section titled “plan_music_cuts”Plan a music video’s scenes from the analysis of the project’s music track. Each slot is one scene with its start and length on the beats. A slot also names its role: a still, a clip, or a clip of the singer. It names its song section, the section’s energy and the lyric heard in it. mode picks story, performance or lyric. Story holds stills on the beats and makes clips in the chorus and the drop. Performance makes clips wherever a voice sings. Lyric cuts and captions at every lyric line.
start and end pick an excerpt, and max_scenes caps the scenes (48 by default, 90 at most). Each clip slot fits the lengths a clip can have, so animating it keeps the cut. A part too short or too long for a clip stays a still, so a low max_scenes can leave the plan with no clips. A plan with a scene longer than 30 seconds fails: raise max_scenes or pick a shorter excerpt.
Without apply, the tool changes nothing, and its result says how to retime the scenes a project already has. With apply, the tool writes the scenes into a project that has none yet. It also makes the track the music master: the video plays the song once at full volume and mutes the clips’ own sound. The result then gives the credits that animating the clip scenes takes, for each scene and in total.
In Manan and on ChatGPT app v2, it also gives the credits of the same scenes as lip-sync clips. The tool itself spends no credits.
- Surfaces: ChatGPT app v2, Generic MCP, Manan
- Parameters:
project_id(required),apply,end,max_scenes,mode,start
set_music
Section titled “set_music”Make your own song or track the project’s music. On ChatGPT app v2, attach the audio file to the chat (audio). The tool also takes the id of an audio file Screel holds, such as a generate_music track. The track replaces the project’s music and keeps its volume. The tool spends no credits, and an attached file counts toward your storage. For a music video, run analyze_audio and plan_music_cuts next.
- Surfaces: ChatGPT app v2
- Parameters:
project_id(required),audio,resource_id
