the interface and the api
are the same declaration

get_creator_profile

A creator's baseline — followers, average likes — and their strongest recent videos, so a single video can be judged against their normal.

get_trending_snapshot

The current curated trending snapshot: top videos ranked by how far each travelled past its own creator's usual reach, with the time the snapshot was captured.

get_video_insight

Metrics, reach and hook for one video already in the database, by URL.

list_insight_coverage

What this database covers: platforms, how many videos, and how fresh the newest capture is.

search_trending_videos

Search Imagine Films' social insights database for high-performing short-form videos.

complete_plan

Carry out a plan.

create_execution_plan

Write the plan that would close the gap, and what each item would cost.

evaluate_against_goal

Judge whether the film now does what was asked.

read_records

What has gone wrong on a film: what Maxwell claimed against what was actually there, and anything you have told it.

read_turn

Where Maxwell has got to: what it understood, the gap it found, the plan and its clashes, which tasks are done and which are not, what it has spent, and which version the film is on.

read_video_reading

What Maxwell saw when it watched: the shots in order, the words on screen, the concerns, and what was heard.

record_mistakes_and_improvements

Tell Maxwell what is wrong — with a film, or with what Maxwell itself did.

understand_goal_gap

Work out the distance between the film as it is and what you asked for.

understand_human

Start Maxwell on a change to a film.

understand_video

Watch a film and say what is actually on the screen — shots, what changes, words you could read, where the eye goes, and anything genuinely wrong like a blank stretch or text off the edge.

create_collection

Start a new collection.

file_inspiration

Put a video the organisation has already kept into a collection.

forget_inspiration

Take a kept video off the organisation's shelf entirely, and out of every collection it was filed in.

keep_inspiration

Keep a video somebody else made, so it can be found again and built from.

list_collections

The organisation's collections of kept videos — name, what the collection is for, how many are in it, and a few covers.

rename_collection

Rename a collection, and optionally rewrite what it is for.

unfile_inspiration

Take a video out of a collection.

compose_film

Generate a film from a written description.

get_generation

Status and output URLs for one generation, by request_id.

list_films

Recent generations for your organisation.

research_creator

Pull a creator's recent post history live and add it to the corpus, so their videos can be judged against their own baseline.

research_video

Pull live data for a video that is not yet in the database, including its full transcript and hook, and add it to the corpus.

detail_software

What Maxwell knows about a product's software — the product map, and each surface with its purpose, copy and design tokens.

issue_ci_token

Connect a repository, so every push keeps Maxwell current.

make_software_clip

Make a clip about one of the product's screens, from what Maxwell already knows about it.

understand_software

Deposit what a product's screens are, so films can be made about them.

apply_bindings

Work out what every binding means right now and commit it as one new version — elements retimed to their moments, and placed against their subjects.

bind_element

Say what an element in the film is ABOUT, rather than where it happens to sit.

check_element_approval_status

Before planning or editing, find out which of a film's elements a person has actually approved.

describe_footage

What is known about the footage in a composition — which clips have been analysed, by what, and what was found.

edit_video_composition

Change a video composition.

evaluate_composition

Check a film before handing it back: that every relationship it claims still resolves, that nothing anchored has walked out of frame, that nothing starts after the film ends, and whether it leans on footage nobody has analysed.

get_render

Where a render has got to.

list_element_bindings

Every relationship this composition claims, and to what.

list_video_composition_versions

The history of a video composition — every change, who made it, and how much it changed.

list_video_compositions

List the video compositions on this account, most recently edited first.

query_footage

Find things inside the footage: people and objects that move ('subject'), spoken words ('word'), musical beats ('beat'), shot changes ('shot'), or notable moments ('moment').

read_evaluation

The most recent verdict on a composition, with every finding.

read_pairing_document

The collaboration so far, oldest first, so it reads as a conversation.

read_screening

What a screening saw, moment by moment — every frame that was looked at, what was on screen, and anything wrong with it.

read_video_composition

Read one video composition: its shape, and every element on its timeline with the times it occupies.

reconcile_tasks

Check a project's task list against what has actually been made in it — the films and whether they have rendered, the master sheets and their scene counts, the museboards, the elements cast — and propose what should change: work the material shows is finished, two tasks that say the same thing, a task whose prerequisite does not exist, work the film obviously needs that nobody has written down.

render_video_composition

Render a composition to an mp4.

request_change

Ask for a change in your own words.

restore_video_composition_version

Bring an earlier version of a composition back.

screen_video_composition

Have Maxwell WATCH the whole film, start to finish, and write down what is on screen.

unbind_element

Take a relationship off.

watch_video_composition

A link that plays this film in a browser, for someone with no account here — hand this to a client rather than making them wait for a file.

write_pairing_note

Add to the record of this collaboration.

answer_journey_questions

Give the Plan the client's answers to the questions Maxwell could not answer itself (which feature, which version, is it released…), keyed by each question's code as read_video_journey shows it.

choose_concept_route

The most important checkpoint: the client picks the idea.

decide_journey_checkpoint

Record the client's decision at a checkpoint: 'approved' (Maxwell starts the next stage) or 'revise' with their note (Maxwell redrafts this stage from it, and everything after it is set aside).

read_video_journey

Read one journey: which stage it is at, each stage's status (working, awaiting_approval, approved…), the drafts so far (Brief, Plan with its open questions, the concept routes with scores and reasons, beats with what the viewer should understand/perceive/feel, elements, look and sound, the film and its quality record), every checkpoint decided, and the jobs running.

render_journey_slots

Render the film's shots once Look & sound is approved.

start_video_journey

Start a pre-production journey from the client's one sentence — who the film is for and what it should do.

find_the_gap

Measure a film against what it was asked to be.

list_documents

What this account has kept — names, kinds and lengths, without the words.

make_composition_from_film

Lay a film you generated on a timeline, so it becomes something you can watch, read in full, measure against a brief and edit.

plan_to_close_the_gap

Turn a gap into something somebody can act on: for each fault, the cheapest route that can actually close it — an edit to the composition, a Seedance `video_edit`, a `video_extension`, a full re-render, or nothing, because some faults have no route and saying so beats paying to find out.

read_document

One kept document, with its words.

read_film_in_full

Read a film the way somebody watching it would, in three passes, and keep what each one says.

read_full_report

Where a full reading has got to, and what one pass said.

refine_prompt

Take a prompt through the loop until it is clean: check, read, revise, again.

render_film

Generate a film from a prompt at a chosen resolution.

render_options

What a render would cost at each resolution, in credits, before anything is spent.

review_prompt

Read a generation prompt the way a creative director does, before anything is generated.

compose⌘↵

Generate a film from a written description.

• promptstring · requiredWhat the film should show.
• referencesnumberCount of attached reference stills or clips. Up to 50.

attach_reference@

Attach a still or clip to steer subject, product or location identity.

• kindstill | clip | product | floorplanReference type.

set_model

Choose the generation model.

• modelaperture-2 | aperture-2-turbo | longform-30s · requiredModel identifier.

set_look←→

Apply a colour science. Changes lighting and stock response, not the subject.

• lookcommerce | training | property · requiredNamed grade.

set_aspect_ratio

Set the output frame shape.

• aspect16:9 | 9:16 | 1:1 | 2.39:1 · requiredWidth-to-height ratio.

set_duration

Set the output length.

• duration4s | 8s | 15s | 30s · requiredClip length.

toggle_audio

Hear one example film. Only one plays sound at a time.

browse_examples

List example films for a given look.

• lookcommerce | training | propertyFilter by grade.
• limitnumberMaximum results.

open_command_palette⌘K

Open the command surface. Identical schema to this manifest.