Filmsquare HelpDocs

5.0 Work with your own Claude5.4 Import from Higgsfield

Import from Higgsfield

Bring your Higgsfield projects into Filmsquare by connecting Higgsfield or with your own Claude - folders, takes with their prompt and model, and your elements - and make shots from a folder.

Updated 6 min read.md

On this page
  1. Connect Higgsfield
  2. What Filmsquare can and cannot do with the connection
  3. Disconnect or reconnect
  4. Ask your Claude
  5. Arrange them in the import window
  6. What comes in
  7. Make shots from a folder
  8. Storage and plan limits
  9. How it works

If your work already lives in Higgsfield, you do not start over. There are two ways in: connect Higgsfield and Filmsquare reads your projects itself, or ask your own Claude to read them and hand them over. Either way Filmsquare copies the files into your production. The crew can then review, sign off, make shots and keep generating from there.

Nothing changes in Higgsfield and the import uses no Higgsfield credits and no Filmsquare credits. Imported takes show "made in Higgsfield · no credits used" instead of a price.

Connect Higgsfield #

No Claude needed. Filmsquare signs in to your Higgsfield account with your permission, read-only, and reads the projects you pick.

  1. Open Settings → Import (or Import from Higgsfield in New production) and choose Connect Higgsfield.
  2. Sign in to Higgsfield and allow Filmsquare. You come back to the screen you were on; on Settings → Import your projects open right away.
  3. Choose Choose projects, tick the projects you want and choose Arrange N projects. One import takes projects from one Higgsfield workspace; clear the ticks to pick from another.
  4. Arrange them in the import window (below) and choose Import. Filmsquare then reads the projects itself, and the progress shows live.

What Filmsquare can and cannot do with the connection #

  • It can list your Higgsfield workspaces and projects, and read the folders, stills, takes, prompts and elements of the projects you import.
  • It cannot generate, change, delete or publish anything in Higgsfield, and it never uses your Higgsfield credits.
  • The connection is yours alone, in this workspace. Nobody else in the workspace can use it, and the sign-in is stored encrypted and never shown.

Disconnect or reconnect #

Open Settings → Import, open the menu next to Higgsfield and choose Disconnect. Filmsquare stops reading Higgsfield right away and forgets the sign-in. Switch account in the same menu disconnects and shows how to sign in with another Higgsfield account. If Higgsfield no longer accepts the sign-in, the import card, the progress and Settings → Import say so and offer Reconnect Higgsfield. If connecting Higgsfield is not set up on your server, Settings → Import says so; the Claude route below still works.

Ask your Claude #

Say which projects you want. For example:

  • "Import my Higgsfield project Sherlock - EPS 8 into Filmsquare."
  • "Bring all my Sherlock episodes from Higgsfield into Filmsquare."

Claude lists your projects and counts what is in them. For a big project (more than 200 takes and stills) it tells you the number first and asks whether to go on. Then it stages the import and gives you a link.

Arrange them in the import window #

Claude's link, Arrange N projects, or an import listed under Imports in Settings → Import opens the import window in the studio. Nothing comes in until you click Import. Closing the window takes you back to where you opened it.

  1. Choose how projects are added by default: Episodes of a series or Standalone productions, and the format (series episode, short film, feature or trailer). The format sets the type of production and the aspect ratio.
  2. Check the list. Filmsquare suggests a series and an episode number from the project names: "Sherlock - EPS 6", "Sherlock - EPS 8" and "Sherlock EPS 9" become one production Sherlock with episodes 6, 8 and 9. Lines Filmsquare arranged itself are marked suggested. Names that do not follow a pattern stay standalone.
  3. Correct what is wrong: drag a line to another group, use Move to… on a line, select several lines and move them together, or make a New series. Every change is saved at once.
  4. Read the checks next to the lines: two episodes with the same number, an episode that already exists (the import is added to it, nothing is replaced), a project you imported before (only the new takes come in), and whether the productions and the storage fit your plan.
  5. Choose Import.

If you would rather stay in the chat, Claude can show you the suggestion, take your changes and confirm the plan for you.

What comes in #

  • Folders, as nested in Higgsfield. A folder stays a folder: it does not turn into a scene by itself. When a project becomes an episode, its folders go under one folder named after the episode.
  • Takes and stills (images and videos, and audio and files that sit in the project), each with the prompt and the model it was made with. Prompts keep their elements: a mention of an element in the prompt reads as its @handle.
  • Elements: the characters, locations and props your takes use, once, as elements of your workspace with their reference images. Every production can use them. When Filmsquare reads Higgsfield itself, it brings in only the elements the project's prompts name, after the takes; your own Claude brings in every element of your Higgsfield workspace. If another Higgsfield workspace is selected, elements are skipped with a quiet warning and their prompt mentions stay as @hf-… placeholders.
  • Liked and favourite marks. They are only a filter ("liked in Higgsfield"), never a pick. You choose the picks.

The same file in two folders is stored once. Importing again later adds only what is new: what is already in is recognised and skipped, and nothing is ever overwritten or deleted.

You see the progress live: folders, takes and elements, and any line that failed with the reason. Takes come in first; a take whose prompt names an element waits for that element. Retry runs the failed lines again, for example after an expired link.

Make shots from a folder #

An imported folder is a heap of material until someone decides what it is. On a folder, choose Make shots from this folder and pick an episode: every image or video becomes a shot in the episode's first scene, with the file as an imported take. You can limit it to the ones you liked in Higgsfield. Doing it twice does not make double shots.

Where a prompt was imported, open the take and use Use as starting prompt to carry it into the composer of a shot.

Storage and plan limits #

Everything is copied into Filmsquare, so the files count toward your plan's storage. As a guide: a still is 1.6-2.8 MB, a video is about 1.5 MB per second (a 15-second 720p take is about 23 MB), and Filmsquare adds about 25% for thumbnails and proxies. An episode of around 150 takes and 200 stills is roughly 3-4 GB.

The Free plan also fits one production. The import window then says so, and suggests putting the projects in one series as episodes. If a plan limit stops an import, what is already in stays, and Retry continues after you upgrade.

How it works #

With Connect Higgsfield, the Filmsquare server reads Higgsfield with your connection, one page at a time and with read tools only, and skips what is already in. If reading stops, the progress shows the reason and offers Read again; when the connection expired, it also offers Reconnect Higgsfield. Stopped projects stay marked Stopped, not complete. Open productions appears only after something came in.

With your Claude: your Claude reads Higgsfield with its own connector and delivers each project to Filmsquare in batches, using the tools in What Claude can do: it finds the import routes with find_actions and runs them with run_action. Filmsquare then fetches the files itself. If the chat is interrupted, ask Claude to continue: it asks Filmsquare what is already in and delivers only the rest.

With Claude

MCP

Your own Claude does this over MCP, in your name and with your role:

  • find_actions

    Searches everything the API can do and returns the matching actions with their inputs.

    Ask: Find the action that changes a step's sign-off rule.

  • run_action

    Runs one action found with find_actions, as you, with your role and rights.

    Ask: Pick the second take of shot 5 on episode 2.

Connect Claude 5.1

This page as Markdown: /docs/claude/import-from-higgsfield.md