browse_films
ChatGPTUse this when the person asks to see examples of films made with KitCut, for ideas. Returns recent films from KitCut's public gallery, which other people made and chose to show: title, the start of the idea each was made from, look, length, its page and its MP4. It performs no action and returns nothing about who made them.
film_progress
ChatGPTUsed only by the KitCut film player itself (the model cannot call it): one film's status and its new progress notes since a point, to refresh the player. It performs no action on the film.
forget_character
ChatGPTUse this when the person asks to remove one of their recurring characters. The character is left out of the person's next films and is no longer listed; films already made keep it. This cannot be undone from here. Confirm with the person first unless they just asked for exactly this.
get_credits
ChatGPTUse this when the person asks how much film they can still make on their KitCut account. Returns the credits left on the account (one credit is one second of film), the credits held for films being made, the longest single film the account can make, the fewest credits any film uses, and the date the credits renew. It performs no action, shows no prices, and nothing can be bought through it.
get_film
ChatGPTUse this when the person asks how one of their films is doing, or wants to watch, share or download it. Returns where the film stands: waiting, being made (with the stage it is at), done (with its page, its share page, its MP4 and how many views it has), or not finished (why, its whole idea, and whether its credits came back). It performs no action on the film. wait_seconds (up to 50) waits for the film to move on before answering.
get_template
ChatGPTUse this before making a film from a template, to learn what it takes. Returns one template: what its film is, an example of what to ask for, how many pictures it takes, its frames and length, about how many credits it uses, and how to make a film from it with make_film. It performs no action.
get_upload_link
ChatGPTUse this when the person asks for a link to add pictures, text files (.txt, .md) or voice notes for their next film from another device, such as their phone, or when the chat shows no film maker to add them in. It creates a temporary upload page for the person's KitCut account (it works for 30 minutes, for up to 12 files) and returns its link for the person to open. Files added there are listed by list_uploads, and are deleted after a day if no film uses them.
list_characters
ChatGPTUse this when the person wants to bring a character back from an earlier film, or asks which characters they have. Returns the characters the person's earlier films drew and kept: name, what each is, and how many films it was in. It performs no action on them. Naming a character in make_film's idea brings it back.
list_my_films
ChatGPTUse this when the person asks to see their films, or refers to a film without its id. Returns the latest films on the person's KitCut account, newest first: title or idea, look, length, status, link and share page, views, whether it is public, and how its credits ended. It performs no action on them. status narrows it to the films being made (making), done, or not finished (not_finished).
list_templates
ChatGPTUse this when the person wants a film for a common occasion (an event invitation, a product video, an announcement) and could start from a ready-made one, or asks what templates there are. Returns KitCut's templates: finished films that can be remade for the person's own occasion from a few words and, if they have them, pictures. Each comes with its slug, title, summary, length, frames, and about how many credits a film made from it uses. It performs no action. get_template explains one; make_film with template makes a film from it.
list_uploads
ChatGPTUse this after the person has added files through an upload link or the film maker, to get their ids for make_film (upload_ids). Returns the pictures, text files and voice notes the person added in the last day that no film has used yet: id, kind, a picture's size, a text file's name and word count, and a voice note's length and the start of its words written out. It performs no action on them.
make_film
ChatGPTUse this when the person asks KitCut to make, create or animate a short animated film from an idea (with or without their pictures), or to make one from a KitCut template. It starts the film on the person's KitCut account and returns at once with the film's id and link. The film itself takes about 8-30 minutes to make, longer for films past a minute (the answer gives an estimate), so follow it with get_film and do not say it is ready. What it changes: it uses credits from the account (one per second of film, at least 30 a film) and fetches any picture_urls given. An account makes one film at a time unless it allows more; a second one is refused with a message that says so. The film is link-only unless public is true. Not for editing existing video footage, and not for photorealistic video. Confirm the idea, the length and the look with the person first unless they already gave them.
open_film_maker
ChatGPTUse this when the person asks to open the film maker, or wants to add pictures from their device or set the idea, the length and the look themselves before a film starts. It shows the KitCut film maker in the chat, filled in with the idea, length and look passed here; the person can edit the idea, add up to 9 pictures and press "Make the film". Opening it starts nothing and uses no credits: a film starts only when the person presses that button. Where the chat shows no film maker (a terminal, for example), nothing opens: ask for the idea, length and look in words, and use get_upload_link for pictures and make_film to start.
remake_film
ChatGPTUse this when the person asks to make one of their films again: a film that did not finish, or another take of one that did, with the idea, length or look changed if they say so. It starts a new film from the first film's whole idea and returns at once, like make_film; the first film stays as it is. What it changes: it uses credits like any film and fetches any picture_urls given. The pictures the first film was given are not kept: pass them again when the new film needs them. A film that belongs to one of the person's KitCut projects is made again as an episode of that project.
set_film_public
ChatGPTUse this when the person asks to make one of their finished films public, or to make a public film link-only again. public true: the film may appear in the public KitCut gallery and in search engines, and what has been seen or indexed there cannot be fully taken back. public false: link-only again; anyone who already has the link can still watch it. Nothing is deleted either way. Confirm with the person before making a film public unless they just asked for exactly this.
start_upload
ChatGPTUsed only by the KitCut film maker itself (the model cannot call it): a short-lived upload address on the person's KitCut account for the pictures they add in the film maker.
stop_film
ChatGPTUse this when the person asks to stop or cancel one of their films while it is waiting or being made. The film stops for good (it cannot be resumed) and its credits come back to the account. Confirm with the person first unless they just asked for exactly this.