---
title: "Importar do Higgsfield"
description: "Traga os seus projetos do Higgsfield para o Filmsquare conectando o Higgsfield ou com o seu próprio Claude - pastas, takes com o prompt e o modelo, e os seus elementos - e faça planos a partir de uma pasta."
url: https://www.filmsquare.ai/docs/pt-br/claude/import-from-higgsfield/
lang: pt-BR
section: claude
updated: 2026-11-16
mcp: [find_actions, run_action]
---

# Importar do Higgsfield

Se o seu trabalho já vive no Higgsfield, você não precisa começar do zero. Há dois caminhos: conectar o Higgsfield e o Filmsquare lê os seus projetos sozinho, ou
pedir ao seu próprio Claude que os leia e os entregue. De qualquer forma, o Filmsquare copia os arquivos para a sua produção. A equipe pode então revisar, aprovar, fazer
planos e continuar gerando a partir dali.

Nada muda no Higgsfield, e a importação não usa créditos do Higgsfield nem do Filmsquare. Os takes importados mostram "made in Higgsfield · no credits used"
(feito no Higgsfield · nenhum crédito usado) em vez de um preço.

## Conectar o Higgsfield

Sem precisar do Claude. O Filmsquare entra na sua conta do Higgsfield com a sua permissão, só para leitura, e lê os projetos que você escolher.

1. Abra **Settings → Import** (ou **Import from Higgsfield** em **New production**) e escolha **Connect Higgsfield**.
2. Entre no Higgsfield e permita o Filmsquare. Você volta para a tela em que estava; em **Settings → Import**, os seus projetos abrem na hora.
3. Escolha **Choose projects** (escolher projetos), marque os projetos que você quer e escolha **Arrange N projects** (organizar N projetos). Uma importação traz projetos de um espaço de trabalho do Higgsfield;
   desmarque tudo para escolher de outro.
4. Organize-os na janela de importação (abaixo) e escolha **Import** (importar). O Filmsquare então lê os projetos sozinho, e o progresso aparece ao vivo.

### O que o Filmsquare pode e não pode fazer com a conexão

- Ele pode listar os seus espaços de trabalho e projetos do Higgsfield, e ler as pastas, stills, takes, prompts e elementos dos projetos que você importa.
- Ele não pode gerar, alterar, apagar nem publicar nada no Higgsfield, e nunca usa os seus créditos do Higgsfield.
- A conexão é só sua, neste espaço de trabalho. Ninguém mais no espaço de trabalho pode usá-la, e o login fica guardado criptografado e nunca é mostrado.

### Desconectar ou reconectar

Abra **Settings → Import**, abra o menu ao lado do Higgsfield e escolha **Disconnect**. O Filmsquare para de ler o Higgsfield na hora e esquece o
login. **Switch account**, no mesmo menu, desconecta e mostra como entrar com outra conta do Higgsfield. Se o Higgsfield não aceita mais o
login, o cartão de importação, o progresso e **Settings → Import** avisam e oferecem **Reconnect Higgsfield**. Se conectar o Higgsfield não está configurado no seu
servidor, **Settings → Import** avisa; o caminho pelo Claude abaixo continua funcionando.

## Peça ao seu Claude

> [!NOTE]
> Você precisa do seu Claude conectado ao Filmsquare, e do conector do Higgsfield no mesmo Claude. Veja [Conectar o Claude](https://www.filmsquare.ai/docs/pt-br/claude/connect/). A leitura é feita pelo
> seu próprio Claude, na sua própria assinatura, então o Filmsquare não paga tokens de IA.

Diga quais projetos você quer. Por exemplo:

- "Importe o meu projeto Sherlock - EPS 8 do Higgsfield para o Filmsquare."
- "Traga todos os meus episódios de Sherlock do Higgsfield para o Filmsquare."

O Claude lista os seus projetos e conta o que há neles. Para um projeto grande (mais de 200 takes e stills), ele diz o número primeiro e pergunta se deve seguir.
Depois prepara a importação e dá a você um link.

## Organize na janela de importação

O link do Claude, **Arrange N projects**, ou uma importação listada em **Imports**, em **Settings → Import**, abre a janela de importação no estúdio. Nada
entra até você clicar em **Import**. Fechar a janela leva você de volta ao lugar de onde a abriu.

1. Escolha como os projetos são adicionados por padrão: **Episodes of a series** (episódios de uma série) ou **Standalone productions** (produções avulsas), e o formato (episódio de série, curta-metragem, longa-metragem ou trailer). O formato define o
   tipo de produção e a proporção de tela.
2. Confira a lista. O Filmsquare sugere uma série e um número de episódio a partir dos nomes dos projetos: "Sherlock - EPS 6", "Sherlock - EPS 8" e "Sherlock EPS 9" viram uma produção
   *Sherlock* com os episódios 6, 8 e 9. As linhas que o Filmsquare organizou sozinho ficam marcadas como *suggested* (sugerido). Nomes que não seguem um padrão ficam avulsos.
3. Corrija o que estiver errado: arraste uma linha para outro grupo, use **Move to…** em uma linha, selecione várias linhas e mova-as juntas, ou faça uma **New series**. Toda mudança é salva na hora.
4. Leia as checagens ao lado das linhas: dois episódios com o mesmo número, um episódio que já existe (a importação é acrescentada a ele, nada é substituído), um projeto que você importou antes
   (só os takes novos entram), e se as produções e o armazenamento cabem na sua assinatura.
5. Escolha **Import**.

Se você preferir ficar no chat, o Claude pode mostrar a sugestão, receber as suas mudanças e confirmar o plano por você.

## O que entra

- **Pastas**, como aninhadas no Higgsfield. Uma pasta continua uma pasta: ela não vira uma cena sozinha. Quando um projeto vira um episódio, as suas pastas ficam dentro de uma pasta com o nome do episódio.
- **Takes e stills** (imagens e vídeos, e áudios e arquivos que estão no projeto), cada um com o **prompt** e o **modelo** com que foi feito. Os prompts mantêm
  os seus elementos: a menção de um elemento no prompt aparece como o seu @nome.
- **Elementos**: os personagens, locações e objetos de cena que os seus takes usam, uma vez só, como elementos do seu espaço de trabalho com as imagens de referência deles. Toda produção pode usá-los.
  Quando o Filmsquare lê o Higgsfield sozinho, ele traz só os elementos que os prompts do projeto citam, depois dos takes; o seu próprio Claude traz todo elemento do seu espaço de trabalho do Higgsfield.
  Se outro espaço de trabalho do Higgsfield está selecionado, os elementos são pulados com um aviso discreto e as menções deles nos prompts ficam como marcadores `@hf-…`.
- Marcas de **curtido e favorito**. São só um filtro ("curtido no Higgsfield"), nunca um take escolhido. Quem escolhe é você.

O mesmo arquivo em duas pastas é guardado uma vez. Importar de novo depois acrescenta só o que é novo: o que já está dentro é reconhecido e pulado, e nada é sobrescrito nem apagado.

Você vê o progresso ao vivo: pastas, takes e elementos, e qualquer linha que falhou com o motivo. Os takes entram primeiro; um take cujo prompt cita um elemento espera por esse elemento. **Retry** (tentar de novo) executa as linhas que falharam de novo, por exemplo depois de um link expirado.

## Fazer planos a partir de uma pasta

Uma pasta importada é um monte de material até alguém decidir o que ela é. Em uma pasta, escolha **Make shots from this folder** (fazer planos a partir desta pasta) e escolha um episódio: cada imagem ou vídeo vira um plano na
primeira cena do episódio, com o arquivo como um take importado. Você pode limitar aos que você curtiu no Higgsfield. Fazer isso duas vezes não duplica os planos.

Onde um prompt foi importado, abra o take e use **Use as starting prompt** (usar como prompt inicial) para levá-lo ao compositor de um plano.

## Armazenamento e limites da assinatura

Tudo é copiado para o Filmsquare, então os arquivos contam no armazenamento da sua assinatura. Como referência: um still tem 1.6-2.8 MB, um vídeo tem cerca de 1.5 MB por segundo (um take de 15 segundos em 720p tem cerca de 23 MB),
e o Filmsquare acrescenta cerca de 25% para miniaturas e proxies. Um episódio de uns 150 takes e 200 stills dá mais ou menos 3-4 GB.

> [!COST]
> O plano Grátis inclui 5 GB, cerca de um episódio desses. O Team inclui 50 GB por licença, cerca de 12-15 episódios. Além disso, o armazenamento custa 2 créditos · € 0,10 por GB por mês. A importação em si não custa créditos.

O plano Grátis também comporta uma produção. A janela de importação avisa e sugere pôr os projetos em uma série só, como episódios. Se um limite da assinatura interrompe uma importação, o que já entrou fica,
e **Retry** continua depois que você faz o upgrade.

## Como funciona

Com **Connect Higgsfield**, o servidor do Filmsquare lê o Higgsfield com a sua conexão, uma página por vez e só com ferramentas de leitura, e pula o que já
está dentro. Se a leitura para, o progresso mostra o motivo e oferece **Read again** (ler de novo); quando a conexão expirou, também oferece **Reconnect Higgsfield**.
Os projetos interrompidos continuam marcados como **Stopped**, não como concluídos. **Open productions** só aparece depois que algo entrou.

Com o seu Claude: o seu Claude lê o Higgsfield com o conector dele e entrega cada projeto ao Filmsquare em lotes, usando as ferramentas de [O que o Claude faz](https://www.filmsquare.ai/docs/pt-br/claude/tools/): ele acha as rotas de importação com `find_actions`
e as executa com `run_action`. O Filmsquare então busca os arquivos sozinho. Se o chat for interrompido, peça ao Claude que continue: ele pergunta ao Filmsquare o que já entrou e entrega só o resto.
