← Back to Tutorial Guide


Meet the FilmSpark Agent

The FilmSpark Agent is the most powerful tool in the console — a director's assistant that lives inside your project. It reads your entire film, plans multi-step work like a crew, and asks permission before it touches a frame. It runs on your API key and on Skills — playbooks that teach it professional craft, which you can extend with your own. You stay in the chair. It does the clicking.

Tell it "change the actor's jacket to red," "storyboard the whole scene," or "swap the lead across the whole project," and it figures out the steps, picks the right model, and shows you the plan before anything touches your storyboard.

vlcsnap-2026-07-21-11h50m19s132.png

ℹ️ Availability: The Agent is live for Pro and Ultimate subscribers. Enter your own API key to use it. Credit estimates are shown for new image and video generations.

Your API key

The Agent runs on your own API key — your account, your control, your spend.

  1. Open the Agent on the far right side of any project and enter your API key. If in a Team Workspace, you can enter this in your Workspace Settings.
  2. Paste the key from your provider dashboard and save. You can add one or more provider keys — OpenAI, Gemini, and Anthropic — and the Agent runs on whichever the job needs.
  3. A green Connected state confirms it. Every request the Agent makes runs through your account, and your key never leaves your workspace.

02-API-keys-dialog.png

03-API-key-connected-tooltip.png

Your Skills

Skills are the playbooks that teach the Agent FilmSpark's craft — the rules a working crew would know: how a scene breaks into beats, which references a model needs attached, how to keep a face and a voice consistent across a hundred shots.

The default pack comes preloaded. Open the Skills panel and every FilmSpark skill is already installed and ready — no setup.

Add your own. Built a technique your team relies on? Upload your own custom skill file — including custom GPT or Claude Skills (.md, .skill, .txt files) — and it runs exactly like ours. This is where the Agent becomes yours.

You never choose a skill by hand. The words in your request do the routing. Name a model ("in Seedance," "for Kling O3") and you get that engine's exact grammar. Name a format ("storyboard panel," "location board") and you get that deliverable. Say neither, and you get FilmSpark's portable house format that works on any model. The Agent names the Skill it's using as it works, so you always know where a result came from.

Agentshot_Cropped.png