> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Elements: personagens, locações e objetos reutilizáveis

> Salve um personagem, uma locação ou um objeto como um element com até oito imagens de referência e diretrizes, depois mencione-o com @ no Seedance Studio para mantê-lo consistente entre as tomadas.

Um element é um sujeito que você quer manter consistente entre gerações: um personagem, uma locação ou um objeto. Ele agrupa até oito imagens de referência com diretrizes escritas sob uma única `@tag`. Anexe o element uma vez e todas as imagens e as diretrizes acompanham o seu prompt.

<Note>
  Os elements estão disponíveis hoje no Seedance Studio, no modo **Video**. Eles chegarão em breve a todas as outras ferramentas da Krea, então tudo o que você salvar agora estará pronto para ser usado lá.
</Note>

<a href="https://www.krea.ai/seedance-studio" className="not-prose group my-6 flex items-center justify-between gap-4 rounded-xl border border-gray-200 dark:border-gray-800 px-5 py-4 no-underline transition-colors hover:border-gray-300 dark:hover:border-gray-700">
  <div>
    <div className="font-semibold text-gray-900 dark:text-gray-100">Abra o Seedance Studio</div>
    <div className="mt-0.5 text-sm text-gray-500 dark:text-gray-400">Os elements ficam no painel References no modo Video.</div>
  </div>

  <span aria-hidden="true" className="text-gray-400 transition-transform group-hover:translate-x-0.5 dark:text-gray-500">→</span>
</a>

## Crie um element

<Steps>
  <Step title="Abra References">
    No Seedance Studio, alterne para **Video** e clique em **References** no compositor. O painel lista tudo o que você salvou em **All**, **Characters**, **Locations** e **Objects**.
  </Step>

  <Step title="Comece um novo element">
    Clique no bloco **New element**. Começar a partir de uma aba de categoria define a categoria para você; começar a partir de **All** permite escolhê-la antes de salvar.
  </Step>

  <Step title="Nomeie e defina a tag">
    Dê um nome ao element, como `Maria`. A `@tag` que você digitará nos prompts é derivada do nome, então `Bolex camera` vira `@bolex-camera`. As tags usam apenas letras e hífens e devem ser únicas entre os seus elements. Você pode editar a tag manualmente.
  </Step>

  <Step title="Adicione imagens de referência">
    Faça upload de até oito imagens do mesmo sujeito. Tomadas de ângulos, distâncias e enquadramentos diferentes dão ao modelo mais material para trabalhar. A primeira imagem é a capa mostrada no painel; clique com o botão direito em qualquer imagem e escolha **Make this the cover** para trocá-la, ou use **Remove image** para descartar uma.
  </Step>

  <Step title="Escreva as diretrizes">
    Descreva o que é o sujeito e o que deve permanecer igual em todas as tomadas, em até 400 caracteres. Por exemplo: `Woman in her early thirties with a sharp jet-black bob, pale skin, and deep burgundy lipstick. Keep the haircut and the black turtleneck in every shot; lighting and setting can change.`
  </Step>

  <Step title="Salve">
    Clique em **Create character**, **Create location** ou **Create object**. O element aparece na categoria dele e em **All**.
  </Step>
</Steps>

## Use um element em um prompt

Clique no bloco de um element no painel References, ou digite `@` no prompt e escolha-o no grupo **Elements**. De qualquer forma, o Studio anexa todas as imagens do element como referências e coloca um chip no seu prompt, por exemplo `Maria walks slowly into the empty warehouse`.

Quando você gera, o modelo recebe as imagens do element, e o prompt nomeia o sujeito e inclui as suas diretrizes para que o modelo saiba quais imagens pertencem ao mesmo conjunto:

```text theme={null}
Maria walks slowly into the empty warehouse. Maria: the character shown in @Image1, @Image2 and @Image3. Woman in her early thirties with a sharp jet-black bob ...
```

Para desanexar um element, exclua o chip dele do prompt, clique no bloco dele novamente ou use **Reset all** no painel. O selo de contagem no botão **References** mostra quantas referências estão anexadas; passe o mouse sobre ele para ver o detalhamento por element.

## Limites de referências por modelo

Cada modelo de vídeo aceita um número limitado de imagens de referência, e os elements contam para esse limite. O Flux 3 aceita apenas um quadro inicial e um final, então elements não podem ser anexados enquanto ele estiver selecionado.

| Modelo                            | Referências de imagem | Total de referências |
| --------------------------------- | --------------------- | -------------------- |
| Seedance 2.5                      | 30                    | 50                   |
| Seedance 2, 2 Fast, 2 Mini        | 9                     | 12                   |
| Hailuo 3                          | 9                     | 15                   |
| Gemini Omni Flash, Omni Flash 1.1 | 10                    | 11                   |
| Flux 3                            | Nenhuma               | Nenhum               |

Se um element tiver mais imagens do que o modelo selecionado comporta, o Studio pergunta antes de anexá-lo: **Remove other references, or truncate this element to X images (down from Y)**. Ao confirmar, as primeiras X imagens na ordem do element são anexadas — mais um motivo para colocar as suas melhores tomadas primeiro.

<Tip>
  Alternar para um modelo com menos slots de referência descarta as referências que ele não comporta, incluindo as imagens de um element. Anexe o element novamente após a troca se ainda precisar dele.
</Tip>

## Edite ou exclua um element

Passe o mouse sobre o bloco de um element e clique no lápis para editá-lo. Você pode renomeá-lo, mudar a tag ou a categoria dele, reescrever as diretrizes, adicionar imagens, remover imagens ou escolher uma nova capa. Salvar um element que está anexado no momento também atualiza as referências anexadas.

Para excluir um element, abra-o e clique em **Delete**. As imagens dele permanecem nos seus assets; apenas o element é removido.

## Dicas para resultados consistentes

* Use tomadas do mesmo sujeito de vários ângulos e distâncias em vez de oito quadros quase idênticos.
* Mantenha as diretrizes focadas na identidade: traços, figurino, materiais ou arquitetura que não devem mudar. Deixe a ação, a iluminação e o cenário para o prompt.
* Mencione o element onde ele age na frase. O Seedance ordena as referências pela ordem em que são mencionadas pela primeira vez.
* Dê a cada element uma tag curta e distinta para que as sugestões de `@` continuem fáceis de escanear.