# Dividir texto

> Corte um texto em uma lista a cada nova linha, vírgula ou separador personalizado, e o próximo nó é executado uma vez por item, como uma imagem por linha.

Source: https://nodaro.ai/pt-BR/docs/nodes/automate/split-text

O nó **Dividir texto** (Split Text) corta um texto em uma lista de itens em um separador, como cada nova linha. O nó que você conecta depois dele é executado uma vez para cada item, então um texto com dez linhas vira dez imagens, dez clipes de voz ou dez vídeos. O Dividir texto não custa créditos e é executado sem modelo.

- Found in: Automate › Text
- Output: text
- API type: `split-text`

## Quando usar
- Escrever um prompt por linha e gerar uma imagem ou um vídeo para cada um.
- Cortar um roteiro em cenas e depois gerar uma tomada por cena.
- Transformar uma lista de assuntos separados por vírgulas em itens separados.
- Cortar a resposta de um nó [**Prompt**](https://nodaro.ai/docs/nodes/automate/prompt) em partes, em um separador à sua escolha.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Automatizar › Texto › Dividir texto**.

### Conectar um texto
Conecte um nó [**Texto** (Text)](https://nodaro.ai/docs/nodes/automate/text), ou qualquer outro nó de texto, à entrada **Texto**.

### Escolher o separador
Abra o painel de configurações e escolha um **Separador**. O padrão, **Nova linha (\n)**, gera um item por linha. A **Prévia** mostra os itens depois de uma execução.

### Conectar o próximo nó e executar
Conecte a saída ao nó que deve ser executado por item, como a entrada **Prompt** do [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image). Execute: o nó é executado uma vez para cada item.

Workflow: Um nó Texto com três linhas vira três itens, e o Gerar imagem é executado uma vez para cada um.

- Texto → Dividir texto (texto)
- Dividir texto → Gerar imagem (prompt)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Texto** | Nós de texto, como Texto, Prompt e **Combinar texto** (Combine Text) | O texto a cortar em itens. |

A saída, **Texto**, é a lista de itens. Um nó conectado a ela é executado uma vez por item.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Separador** | Onde o texto é cortado: **Nova linha (\n)** (o padrão), **Nova linha dupla (\n\n)**, **Vírgula (,)**, **Espaço**, **Três asteriscos (\*\*\*)** ou **Personalizado**. |
| **Separador personalizado** | O separador que você mesmo digita, quando **Separador** é **Personalizado**, por exemplo `===NEXT===`. |
| **Aparar espaços em branco** | **Ativado** (o padrão) remove os espaços e as quebras de linha em volta de cada item. |
| **Remover vazios** | **Ativado** (o padrão) descarta os itens vazios, como os que as linhas em branco criam. |
| **Prévia** | Os itens da última execução, numerados. Somente leitura. |

## Uma execução por item ou todos os itens de uma vez
Uma conexão que sai do Dividir texto fica no modo **Cada item** por padrão: o próximo nó é executado uma vez para cada item, e você recebe um resultado por item. Clique na conexão para mudar o modo:

| Modo | O que o próximo nó recebe | Use para |
| --- | --- | --- |
| **Cada item** (padrão) | Um item por execução | Uma imagem, um vídeo ou um clipe de voz por item |
| **Conjunto** | Todos os itens juntos, em uma execução | Nós que combinam um conjunto inteiro |
| **Item** | Um item que você escolhe pela posição, como `2` ou `last` | Usar um único item |

Nos modos **Cada item** e **Conjunto**, você também pode passar só alguns itens, como `1..5` para os cinco primeiros. Leia [Listas e lotes](https://nodaro.ai/docs/concepts/lists-and-batching) para ver todas as opções.

## Créditos
O Dividir texto em si é gratuito. O nó depois dele é cobrado uma vez por item, então o custo cresce com o número de itens. Dez itens em um nó que custa 20 créditos custam cerca de 200 créditos. O botão **Executar** desse nó mostra o total antes de você começar.

## Dicas
- **Confira a prévia primeiro.** Execute o Dividir texto sozinho e leia a **Prévia** antes de executar um nó caro depois dele.
- **Teste com poucos itens.** Configure a conexão para passar só `1..2` enquanto testa um workflow e depois remova o intervalo para a execução completa.
- **Deixe um modelo escrever os itens.** Um nó [Prompt](https://nodaro.ai/docs/nodes/automate/prompt) pode escrever vários prompts de uma vez. A saída **Itens** dele já divide a resposta em `===NEXT===`, então você não precisa do Dividir texto para esse separador.
- **Para uma tabela de valores, use uma Lista.** Quando cada execução precisa de vários valores, como um prompt e uma imagem, um nó [**Lista** (List)](https://nodaro.ai/docs/nodes/automate/list) guarda uma linha por execução.

## Frequently asked questions

### O que o nó “Dividir texto” faz?

O “Dividir texto” corta um texto em uma lista de itens em um separador, como cada nova linha. O nó conectado depois dele é então executado uma vez para cada item. O “Dividir texto” em si não custa créditos.

### Como gero uma imagem por linha de texto?

Escreva um prompt por linha em um nó “Texto”, conecte-o ao “Dividir texto” com o separador “Nova linha” e conecte o “Dividir texto” à entrada “Prompt” do “Gerar imagem”. O “Gerar imagem” é executado uma vez por linha.

### Por que aparecem itens vazios?

Os itens vazios vêm de linhas em branco ou de separadores duplicados. Mantenha “Remover vazios” ativado, que é o padrão, e o “Dividir texto” os descarta.

### Como passo todos os itens para um nó de uma vez?

Clique na conexão depois do “Dividir texto” e mude-a para “Conjunto”. O próximo nó é então executado uma vez e recebe todos os itens juntos.

### Quanto custa uma execução do “Dividir texto”?

O “Dividir texto” é gratuito, mas cada item executa o próximo nó uma vez. Dez itens em um nó de imagem que custa 20 créditos custam cerca de 200 créditos. O botão “Executar” do próximo nó mostra o total antes de você começar.