Agent Social

Every post the creator has made, newest first, 20 per page. Each post has its id, status, platforms, a short preview of its words, when it was made, scheduled and published, links to where it was published, and the chat it lives in: a video studio episode or a posts chat, with the link that opens it in Agent Social. A video post also carries its series and episode ids. Filter by status, platform, kind, episode, chat, dates, or words in the post. Pass next_cursor back as cursor for the next page. Read only: publishing happens in the app; to schedule a post, ask its agent (the studio or the posts agent) with talk_to_agent.

list_my_posts

Files the creator uploaded (photos, videos, audio), newest first, 10 per page, each with its id, name, kind, upload time and the creator's own sentence for it (caption, empty when they wrote none), and a picture of each image. Search by words in the file name. Pass next_cursor back as cursor for the next page.

list_my_files

The creator's series, episodes, chapters, takes, characters, places and props, newest first, 20 at a time. Optionally narrow by words in the name or title, by kind (default: series and episodes), by series, by status (not rendered, rendering, done) or by changed since a date. Each item has its title, kind, where it sits, status, last changed, thumbnail, its ids, and for episodes the link to open it in the app.

list_my_work

Every picture of one or more places, as images: for a filmed place, every view cut from its current place films. Each view has its place picture id, the place id, its time on the film, its description, the sentence you wrote under it if it is your photo (caption), its look, whether it is hidden, where it was taken from and which way it faces, and whether it is named yet. Give episode_id to also get each place's takes_on_older_pictures: that episode's clips still on out-of-date pictures of it. To change a place or its pictures, ask the studio with talk_to_agent.

list_place_views

The video and image models in use and the ones that could be chosen. Video: the default a new film starts on and, with episode_id, that episode's model and resolution; then every video model with model_id, whether this episode (or a new film) can use it and why not, its resolutions, the clip lengths it films, whether it makes sound, and a rough price per resolution. Image: the default model, size and quality, and every image model with its sizes and quality levels. Free. The creator changes a model in the app's Model picker or by asking the studio.

list_models

Every clip of a chapter in order: what it is meant to show, the screenplay with dialogue, narration, feeling, sound, the camera in plain words, length and render status, with a thumbnail picture of each rendered clip. A clip with place pictures that are out of date or the wrong shape carries place_pictures_out_of_date, with the newer_place_picture_ids to swap in; the other clips do not.

get_chapter

A clip in full: what it is meant to show, the screenplay with dialogue, narration, feeling, the camera in plain words, length and render status; who and where is on it with the look each uses; every rendered take with its video link, the picked one marked; for a cut clip, what is kept and cut on the original render's clock; film_speed when not 1; and the pictures it is made from, each labelled with its role (character, place, or the previous clip's end). saved_frames: frames kept under it (id, second, label, picture). reference_images: pictures pinned to the take, in order, with type and url. moments: the stills painted for it, whether each is on the take and the pictures it was painted from; they come as images: look at each beside its pictures. ready_to_render: whether it can be filmed now, and waiting_on what blocks it. place_pictures_out_of_date: its place pictures that are out of date. render_limits: the video model's picture and voice limits. opening: the clip before and both clips' places. fingerprint changes whenever anything about it changes. in_story: its chapter with its story, and the clips either side. include_pictures false skips the pictures. To change anything, ask the studio with talk_to_agent.

get_clip

A series' bible — audience, platform, target length, format rules, and the recurring cast, places and props with their default looks — plus every episode at a glance: number, title, one-line story, status, runtime, takes rendered, last changed, thumbnail and link. Long series come in pages of 25 episodes.

get_series

An episode's brief and look (lens, light, palette, era), its story plan (premise, emotional promise, world rules, character arcs, voiceover), the acts and sequences outline, every chapter with its clip count, runtime and render status, the finished film link (final_film_1080p_url too, only while its 1080p film matches the current film), the episode's settings (aspect ratio, resolution, clip length, language, and clip_limits: the lengths its video model renders, pictures and speaking voices per clip, the voice-sample seconds a clip may carry, and how many places one clip may be set in), and its link in the app. Read clip_limits before planning or writing clips. Says plainly what the episode does not have yet.

get_episode

One or more post cards, by post id or by episode id. Each card has its ids, the platforms and accounts it goes to, the X post text, the YouTube title, description, tags and category, the Instagram caption and the Facebook title and description (video posts), the thumbnail or pictures, whether it tells sites it was made with AI, its state with links to where it was published, and the chat it lives in with its link. To change a post, ask the studio (a film's post) or the posts agent (a text or image post) with talk_to_agent; ask the same agent to schedule it. Publishing happens in the app.

get_post

Every picture of one or more characters or props at full size: face close-up, full body, turnaround, the glued sheet sent with each take, and each look's pictures, each with its picture id and kind, plus the asset id and look ids.

see_character

Stop what the creator's Agent Social agent is doing in one chat — the chat's own Stop button. The current step finishes and nothing new starts. Name the chat by episode_id or session_id. Stop only when the creator clearly says stop, never on a guess; and never stop a turn to patch a message you sent: gather everything first, then send once.

stop_agent

Watch an episode 5 clips per page, in playing order. Each clip comes as one grid image of up to 16 timed frames (left to right, top to bottom), with its screenplay, narration, sound, music and timed lines when there are subtitles, and its cut points: where it starts and ends in the finished episode, plus a link to its video. Also returns the total number of pages. Clips not rendered yet, or rendering, say so. Use watch_clip for a closer look. Watching is free.

watch_film

Watch one or more rendered clips (up to 5 per call). For each: the picked take (or the take you name) as grid images of up to 16 frames with the time on every tile, read left to right, top to bottom; the first and last frame at full size; the pictures the clip was made from, to compare with what came out; the screenplay, narration, sound and music, and timed spoken lines when the episode has subtitles; which take it is, its length, and a link to its video for a client that can play video. For a cut clip, the stretches kept and thrown away. film_speed when the film plays it faster or slower. A clip that is not rendered yet returns only its pictures; a clip that is rendering says to try again shortly. frames_per_second is your choice, anywhere up to 4; left out, it is 2, the least that shows motion: watch the whole take at 2 or more before calling a render good. Frames carry no sound, so say you could not judge voices, lip sync or music. Acting, camera moves and natural sound you didn't write come from the studio's own direction and are intended; the place's life is written in the clip. Flag them only when they break the story, such as an extra person speaking or a changed place. Flag a cut the clip didn't ask for: cuts are where continuity breaks. Watching is free.

watch_clip