Put a video into a bin. Needs an API key with the Editor role.

Create a new bin to collect videos in. Returns the new bin including its id. Needs an API key with the Editor role.

List the scene thumbnails of one video in timecode order. Use this to see how a video is structured before deciding which moment to look at. Returns totalCount so you can tell whether there are more than you asked for.

Get one catalog entry by its id, including title, description, path, length and rating.

Search the people recorded in the user's Fast Video Cataloger catalog, by name or by the tags on them. These are the cast of their own footage, not contacts.

List the videos collected in one bin. A bin can hold the whole catalog, so this returns the first 50 by default - check totalCount and page with offset.

Remove keywords from a video - the counterpart to tag_video, for undoing a tag that was added in error. Name the keywords exactly as get_video_tags reports them; only those are removed and every other tag on the video is left alone. Other videos keep the keyword, but a keyword that no video uses any more also disappears from the catalog's keyword list. Returns what was removed and what did not match. Needs an API key with the Editor role.

List the people recorded as appearing in a video.

List catalog entries that have no scene thumbnails or no known length yet. Pass each id to index_video to work through them. A newly added folder can leave thousands pending, so this returns the first 50 by default - check totalCount and page with offset to walk the rest.

Search what is said out loud in the user's Fast Video Cataloger videos. Returns the matching transcript lines themselves - each with the id of the video it belongs to (videoFileID) and its start and end time in seconds, so you can go straight to the moment. Use get_video_transcript to read the lines around a hit. Only videos that have been transcribed are searched.

Remove keywords from a single scene thumbnail - the counterpart to tag_scene. Only the named keywords are removed from that one scene; other scenes and the video's own tags are untouched. A keyword that no scene uses any more also disappears from the catalog's scene keyword list. Returns what was removed and what did not match. Needs an API key with the Editor role.

Add keywords to a single scene thumbnail rather than the whole video. Needs an API key with the Editor role.

Fetch the actual image of a scene thumbnail so you can see what is in the shot. Get thumbnail ids from search_scenes, search_scenes_semantic or get_video_scenes.

Ask the server to index a video that is in the catalog but has no scene thumbnails yet. Extracts thumbnails and duration, plus whatever else the server is configured for such as transcription. This takes minutes and runs in the background - poll get_video_scenes to follow it. Needs the Editor role.

List the keywords a video is tagged with.

Search the user's Fast Video Cataloger catalog - their local library of video files, not cloud storage or the file system. Use this for any question about their videos, footage or clips. Use 'query' for a free text search over titles, descriptions and keywords, or 'keywords' for a comma-separated keyword match. Returns catalog entries including each video's id, title, path and length.

List the bins in the user's Fast Video Cataloger catalog. A bin is a user-made collection of videos, like a folder of shortlisted clips.

Search individual scenes inside the user's Fast Video Cataloger videos, rather than whole videos. This is how you find the moment inside a video: each result carries a thumbnail id, the video it belongs to, and its timecode. Pass the thumbnail id to get_scene_image to look at it.

List every keyword that exists in the whole Fast Video Cataloger catalog, rather than the keywords on one video. Use it to find out what you can actually search for before guessing - a keyword that is not in the catalog simply returns nothing. This is the vocabulary only, with no counts, and it mixes keywords the user typed with ones written automatically by object detection, so a catalog can list things like 'zebra' or 'toaster' that appear nowhere in the footage. Both scopes can contain either kind. To find out whether a keyword is really used, search for it.

Add keywords to a video. Existing tags are kept. Needs an API key with the Editor role.

Find scenes by describing what is in the picture - 'a dog running on a beach', 'close-up of hands typing', 'city skyline at night'. Nothing has to be tagged: every indexed scene is ranked by how well it matches the words, so use this when the keywords search_scenes needs do not cover what you are after, and use similarTo to find footage that looks like a scene you already have (the source scene itself is left out of those results). Results come best first, each with the thumbnail id, the video, the time (seconds and hh:mm:ss) and a relevance score. Judge by the order, not the number: for a description a good match scores only about 0.15-0.30, while scenes that look like a given one score 0.8 and above, and scores are comparable only within one search. Pass a thumbnail id to get_scene_image to check what a scene really shows. If the answer says the model or the index is missing, tell the user what to do; do not retry.

How many videos, actors and images the Fast Video Cataloger catalog holds. This is the user's local video library, not cloud storage or the file system. Useful as a first call to confirm the connection works and to judge how broad a search should be.

Get the transcript of a video as timed lines. Empty if the video has not been transcribed. A feature-length transcript is very long, so this returns the first 200 lines by default - check totalCount and page with offset if you need the rest.