Atlabs Ai

Add an empty shot to a scene of the user's Atlabs story (a scene can show several shots one after another). Ask the user where it goes; with no position it is added last. position is 1-based. Free. Fill it with scene_edit_image or set_shot_media. If the user has this story open in the Atlabs editor, tell them to reload it to see the change.

create_shot

Create a story from the ready plan made with plan_story, like a MiniTool: pass its session_id (plan_mode_session_id) and the chosen ai_output_mode: STORYBOARD (images), VIDEO_PREVIEW (preview video), or VIDEO (full video). Call it only after the user clicks Start in the plan panel ("Start my <mode> for <N> credits."), with approved_credits=N: the call prices the plan as saved now and starts it at once, charging credits. If the price is now above N it is refused and nothing starts: tell the user the new price and let them click Start again. Once started, reply with one short status line and story_url as a clickable full-domain link; do not recap the plan or the panel choices. Then call get_story_generation_status once: its panel shows live progress. Then call wait_for_story again and again (up to 45 seconds per call) and write nothing in between. When it is done, failed or paused, reply with story_url as a clickable full-domain link. After 10 minutes it says to stop: say in one line that it is still generating and ask whether to check again; on a yes, call wait_for_story again. Never infer completion from the clock. Use get_story to read the story and get_story_assets to inspect generated assets. Export is a separate action with export_story; do not promise an exported video here. If starting failed after submission, call create_story again with the same arguments: it finds the existing story at zero additional start credits and retries dispatching it, never creates another.

create_story

Delete one line (line_id) from a story's screenplay. To empty a scene, use screenplay_delete_scene instead. Works only while the story's workflow waits on its Screenplay review screen (get_screenplay says is_editable); ids are the ones get_screenplay returns. The change applies whole or not at all: it is refused when it would leave what the web app refuses at Continue (a dialogue without a speaker or text, an action without a word, a scene without a line, or without a location unless the workflow allows none). For several changes, call the edit tools one after another; add before you delete, so no step leaves a scene empty. Each call saves on its own: if a later one is refused, the earlier ones stay saved, so tell the user what did and didn't change. Make only the changes the user asked for, with their words. Returns the screenplay as it is now: tell the user what changed in one or two lines.

screenplay_delete_line

Delete one scene (scene_id) of a story's screenplay, with all its lines. Works only while the story's workflow waits on its Screenplay review screen (get_screenplay says is_editable); ids are the ones get_screenplay returns. The change applies whole or not at all: it is refused when it would leave what the web app refuses at Continue (a dialogue without a speaker or text, an action without a word, a scene without a line, or without a location unless the workflow allows none). For several changes, call the edit tools one after another; add before you delete, so no step leaves a scene empty. Each call saves on its own: if a later one is refused, the earlier ones stay saved, so tell the user what did and didn't change. Make only the changes the user asked for, with their words. Returns the screenplay as it is now: tell the user what changed in one or two lines.

screenplay_delete_scene

Edit a character of the user's Atlabs story (element_id from list_story_characters), like saving the cast's edit modal: only the fields given change. Which fields can change depends on where the portrait came from (`editable_fields` in list_story_characters); a drawn portrait's look (visual_appearance, clothing, age, gender, ethnicity), a library pick's clothing, or an upload's restyle (apply_style_transfer) redraws the portrait in the background, charged like the web app's redraw; a rename alone redraws nothing. height_cm only matters in stories that size characters. Change a voice with set_character_voice. Scenes already made keep the old look until they are regenerated. If the user has this story open in the Atlabs editor, tell them to reload it to see the change.

edit_character

Edit a location of the user's Atlabs story (element_id from list_story_locations), like saving the location form: only the fields given change. A drawn location (portrait_origin CREATE) with a new description is redrawn in the background, charged like the web app's redraw; a rename alone redraws nothing. An uploaded location only takes a new name; a library pick keeps its library image. Scenes already made keep the old look until they are regenerated. If the user has this story open in the Atlabs editor, tell them to reload it to see the change.

edit_location

Edit a product (object) of the user's Atlabs story (element_id from list_story_products), like saving the cast's edit modal: only the fields given change. Any real change - even a rename - redraws the portrait in the background, charged like the web app's redraw. apply_style_transfer restyles an uploaded or library image into the story's style. Scenes already made keep the old look until they are regenerated. If the user has this story open in the Atlabs editor, tell them to reload it to see the change.

edit_product

Export the story to a video. Only for MAKING an export - to read one, use get_story_export. Steps: 1. Call export_story(story_id), with a resolution only if the user asked for one (default 2K). It starts the render at once; its credits are charged when it finishes. 2. Call get_story_export(story_id) until its status is READY (usually a few minutes). A story already exported can be exported again (the story changed, or the user wants another resolution): that is a new render and costs credits again, so export again only when the user asked for a new export, and say what it cost. While one is still rendering this is an error - call get_story_export until its status is READY.

export_story

Make images from a text prompt, optionally guided by the user's reference images (e.g. edit a photo, keep a product or character consistent). Steps: 1. Work out what the user gave, then read the model list, list_models(tool="generate_image") (the default model comes first): reference or photo to edit -> upload each and pass them as reference_media_ids text only -> no files If the files don't fit a model, the call says which models take them and how to fix them. 2. Choose the model yourself from that list: the default unless the user named one or another fits the request clearly better (references, text in the image, style). 3. Call generate_image with that model. Leave resolution and quality out unless the user asked for them, so the model's defaults apply. It runs at once and returns a request_id.

generate_image

Make a song or instrumental from a description. The models are in list_models(tool="generate_music") (default first), each with whether it takes lyrics, a mood image or force_instrumental, and the exact duration_seconds values it allows (none: it picks its own length). If the user wants vocals but gave no lyrics, write them yourself (for MiniMax) or use ElevenLabs or Lyria. Steps: 1. Call generate_music. It runs at once and returns a request_id.

generate_music

Make a video: animate a start image, go from text to video, or build a video from reference images, videos or audio. Videos take a few minutes. Steps: 1. Work out what the user gave, then read the model list, list_models(tool="generate_video") (the default model comes first): an image to animate -> upload it and pass it as start_frame_media_id a text idea only -> no files people/products/voice -> upload each and pass them as reference_*_ids as references If the files don't fit a model, the call says which models take them and how to fix them (trim, upscale, reframe). 2. Choose the model yourself from that list: the default unless the user named one or another fits the request clearly better (length, audio, references). 3. Call generate_video with that model and options it supports (duration in seconds, aspect ratio, resolution, audio). It runs at once and returns a request_id.

generate_video

The user's own Atlabs account: their name and email, their credit balance, and their plan (whether it is paid, its name and status, when it renews or ends). Read it to answer 'how many credits do I have' or 'what plan am I on'. The balance here is their general one; a MiniTool's own price can show MORE credits available, because some credits are only spendable on certain tools - for whether one generation is affordable, trust that tool's price.

get_account

What the story plays under its scenes now: the track (name, genre, moods, length, preview link), whether music is on, and its volume (0-1).

get_background_music

Wait for a MiniTool job by request_id and show its outputs. Each call waits up to 45 seconds and returns as soon as the job finishes: "success" comes with outputs (url and media_type each) and a player in the chat. Still "created" or "processing": call it again with the same request_id (for at most 10 minutes; its next_step says when to stop). A failed job is a tool error. Showing the result: - The chat app shows the outputs itself (image, playable video or audio). - One short line on what was made. Never paste a file's URL into your reply unless the user asks for a link: the player has its own Download and Open buttons, and the link expires. - Say which model and options were used and the credits spent, in one line, from the call's answer (this result does not repeat them). - Offer 2 or 3 next steps that fit, e.g. upscale_media, reframe_media to another aspect ratio, or generate_video to animate an image. Each output's media_id goes straight into the next tool: nothing needs re-uploading.

get_result

One scene of a story: each shot's current file and its earlier generations (newest first), and the same for the scene's voiceover. Any media_id here can go to show_media, to a MiniTool, or back onto a shot with set_shot_media.

get_scene_assets

One scene's captions: each word with its start and end in seconds from the scene's start, where the words come from (the voiceover, or a lip-sync clip's sound), and whether captions show in this scene and in the story. A new voiceover replaces them.

get_scene_captions

Read a story's screenplay, as the Atlabs web app reads it. screenplay.scenes are in order: id (the scene_id), location (a location element_id), INT/EXT, time of day, duration, and elements (the lines): id (the line_id), element_type ACTION (text in description) or DIALOGUE (text in dialogue), the speaker as character_story_element (an element_id from screenplay.cast) or, on an older line, as character (the cast member with that legacy_id), emotions and shot_duration_seconds. screenplay.locations names the location ids. Changes nothing. is_editable is true only while the story's workflow waits on its Screenplay review screen; then the screenplay_* edit tools (update, add, delete or move a line or a scene) can change it. problems lists what the web app would refuse when the user continues; offer to fix them.

get_screenplay

One story: its scenes, length, the inputs the user gave it (prompt, script, style, track, avatar - whatever its flow asked for), and its latest export with a fresh download link when that is ready. Each scene carries the `scene_id` scene_edit_voiceover takes. `cast` lists its characters, products and locations: the `mention` a story-edit prompt tags each by, its portrait, and the `element_id` set_character_voice takes.

get_story

The media a story is built from, as media_ids any MiniTool takes. A visual also carries the `aroll_id` and `shot_number` of the shot it is in: the handle scene_edit_image, _motion and _lipsync take. A scene can hold several shots, so a media_id alone does not say which shot to edit.

get_story_assets

The story's latest exported video: its status, resolution and a download link once it is READY. Null until it has been exported.

get_story_export

A story's live progress panel: progress, current step and approximate time left, updating itself. Call it once, right after create_story starts the story, then call wait_for_story.

get_story_generation_status

The clip the user chose after trim_in_browser (media_id, url, duration_seconds). Pass the token trim_in_browser returned. Call it after the panel posts "Done - I trimmed the clip ..."; it checks once, without waiting. The panel already plays the clip to the user: do not call show_media for it unless they ask to see it again.

get_trim_result

The file the user picked after upload_from_browser (media_id, url, width, height, duration_seconds). Pass the token upload_from_browser returned. Call it right after upload_from_browser: it waits up to a minute for the pick and returns as soon as the file arrives. The panel already shows the file to the user: do not call show_media for it unless they ask to see it again.

get_upload_result

Make a face speak an audio track: re-sync the lips in a video, or turn a photo into a talking video. Without `model`, the first that fits the face (image or video) is used; the models and what each takes are in list_models(tool="lip_sync"). The output is about as long as the audio. Steps: 1. Get the face (an image or a video) and the speech audio media_ids. There is no text-to-speech here: the user supplies the audio. 2. Call lip_sync. It runs at once and returns a request_id.

lip_sync

The image styles a new story can take: Atlabs' own (SYSTEM) and the ones the user made (USER), each with a preview image. Choose the one that fits the story, unless the user named one, and pass its image_style_id to create_blank_story.

list_image_styles

List the characters from the user's character library (their own and Atlabs actors) that can be added to this story, newest first, at most 50; `search` matches the name. Read only. Show the user the options and let them choose: never pick one for them.

list_library_characters

List the locations from the user's location library that can be added to this story, newest first, at most 50; `search` matches the name. Read only. Show the user the options and let them choose: never pick one for them.

list_library_locations

List the products (objects) from the user's library that can be added to this story, newest first, at most 50; `search` matches the name. Read only. Show the user the options and let them choose: never pick one for them.

list_library_products

The user's Atlabs FILES - uploads and MiniTool outputs, not their stories - newest first. Filter with media_type (image, video or audio) and limit (1-100). "my video", "my latest video" (or music, image) is ambiguous: a STORY (a film they built in Atlabs: list_stories, whose finished video is get_story_export) or a FILE (uploaded, or made by a MiniTool: list_media). Most Atlabs users mean a story. Resolve it, stopping at the first that applies: 1. They named it -> that one. 2. It was made or uploaded earlier in this chat -> that one. 3. Otherwise ask "your story, or a file in your library?" and wait. For the latest library video, use media_type="video" and limit=1. Call show_media with its media_id to display it. To let the USER choose a file, call pick_media instead.

list_media

The models a tool offers and what each one takes (aspect ratios, durations, resolutions, reference limits, and input_limits: each input file's size, dimensions, length and format, checked before the run), default first. Pass a model's `model` value to that tool. tool is one of: generate_image, generate_video, upscale_media, reframe_media, modify_video, motion_control, lip_sync, generate_music, scene_edit_image, scene_edit_motion, scene_edit_lipsync. The same list as the resource atlabs://minitools/<tool>/models.

list_models

The background-music tracks this account can use (Atlabs' library and their own), shown to the user as a list with a player for each one's preview. Choose a track yourself by its genre, moods and length to fit the story, unless the user names one or picks it in the panel. Don't list the tracks again in the chat: the panel shows them. The panel also takes their own audio file (drop, paste or choose). Pass the story's story_id: then the user's pick or upload is set on the story by the panel itself, and the message you get back says it is saved - don't call set_background_music for it. Without a story_id the message gives you the music_id or media_id to pass to set_background_music. A track the user names in the chat is set with set_background_music, without the panel. search matches a name, genre or mood; pass current_music_id to mark the story's track, and offset for the next page.

list_music

The user's stories - the films they build in Atlabs - most recently edited first. Optional search (a name or a story id), page and page_size. "my video", "my latest video" (or music, image) is ambiguous: a STORY (a film they built in Atlabs: list_stories, whose finished video is get_story_export) or a FILE (uploaded, or made by a MiniTool: list_media). Most Atlabs users mean a story. Resolve it, stopping at the first that applies: 1. They named it -> that one. 2. It was made or uploaded earlier in this chat -> that one. 3. Otherwise ask "your story, or a file in your library?" and wait.

list_stories

List the characters of the user's Atlabs story, with their details: name, look, clothing, voice, where their portrait came from and which fields edit_character can change on each (none on one `is_shared` from another of the user's stories: edit it there). Read only.

list_story_characters

List the locations of the user's Atlabs story: name, description (what the place looks like) and where its portrait came from. One `is_shared` from another of the user's stories is edited there. Read only.

list_story_locations

List the products (objects) of the user's Atlabs story: name, look (visual_appearance), where their portrait came from and whether a supplied image is restyled. One `is_shared` from another of the user's stories is edited there. Read only.

list_story_products

The voices this account can use for a scene voiceover, shown to the user as a list with a player for each one's preview. Choose one yourself from each voice's language, gender and description to fit the story, unless the user names one; if they pick one in the list instead, their pick comes back to you as a message. Each voice has its voice_code (what scene_edit_voiceover takes), pause_style (tagged: [pause]; timed: <break time="1s"/>; null: no pauses), takes_emotion and takes_pronunciations. Pass a `language` to narrow it (e.g. english), current_voice_code to mark the scene's voice, and offset for the next page.

list_voices

Edit one of the user's videos with a prompt (e.g. "make it snow", "change her jacket to red"), optionally guided by reference images. The models, how many references each takes and which keep the original audio are in list_models(tool="modify_video") (default first). Steps: 1. Get the video's media_id (upload it, or list_media) and any reference images. 2. Call modify_video. It runs at once and returns a request_id.

modify_video

Make the character in an image perform the motion of a driving video (dance, gestures, acting). The price follows the driving video's length. The models are in list_models(tool="motion_control") (default first). character_orientation: "video" (default) follows the video's framing, "image" keeps the image's; keep_original_sound keeps the video's audio (default true). Steps: 1. Get the character image and the driving video media_ids. 2. Call motion_control. It runs at once and returns a request_id.

motion_control

Move one line (line_id) to position (0-based) within its own scene of a story's screenplay. Works only while the story's workflow waits on its Screenplay review screen (get_screenplay says is_editable); ids are the ones get_screenplay returns. The change applies whole or not at all: it is refused when it would leave what the web app refuses at Continue (a dialogue without a speaker or text, an action without a word, a scene without a line, or without a location unless the workflow allows none). For several changes, call the edit tools one after another; add before you delete, so no step leaves a scene empty. Each call saves on its own: if a later one is refused, the earlier ones stay saved, so tell the user what did and didn't change. Make only the changes the user asked for, with their words. Returns the screenplay as it is now: tell the user what changed in one or two lines.

screenplay_move_line

Move one scene (scene_id) to position (0-based) in a story's screenplay. Works only while the story's workflow waits on its Screenplay review screen (get_screenplay says is_editable); ids are the ones get_screenplay returns. The change applies whole or not at all: it is refused when it would leave what the web app refuses at Continue (a dialogue without a speaker or text, an action without a word, a scene without a line, or without a location unless the workflow allows none). For several changes, call the edit tools one after another; add before you delete, so no step leaves a scene empty. Each call saves on its own: if a later one is refused, the earlier ones stay saved, so tell the user what did and didn't change. Make only the changes the user asked for, with their words. Returns the screenplay as it is now: tell the user what changed in one or two lines.

screenplay_move_scene