# Lista

> Digite ou cole uma lista de prompts, ou monte uma tabela com várias colunas, e cada nó conectado é executado uma vez por linha. O nó Lista é gratuito.

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

O nó **Lista** (List) guarda uma lista de valores, e cada nó conectado a ele é executado uma vez por linha. Digite ou cole um prompt por linha para fazer um lote de imagens, vídeos ou narrações em uma única execução. O nó Lista não chama nenhum modelo e não custa créditos.

- Found in: Automate › Lists & Batching
- Output: data
- API type: `list`

## Quando usar
- Você tem 10 prompts e quer uma imagem para cada um deles.
- Você quer executar o mesmo workflow de vídeo para vários assuntos ou produtos.
- Você quer uma narração para cada linha de um roteiro, com o [**Texto para fala** (Text to Speech)](https://nodaro.ai/docs/nodes/audio/text-to-speech).
- Você precisa de mais de um valor por execução, como um prompt e uma imagem de referência para cada vídeo. Transforme a lista em uma tabela, com uma coluna por valor.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Automatizar › Listas e lotes › Lista**.

### Adicionar as linhas
Abra o painel de configurações e digite um valor por linha. Clique em **Adicionar linha**, ou pressione Enter, para adicionar a próxima linha. Arraste uma linha pela alça para movê-la.

### Conectar o nó
Arraste da saída da Lista até a entrada que deve mudar a cada execução, por exemplo a entrada **Prompt** do [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image). Uma conexão que sai de uma Lista fica no modo **Cada item**, que executa o próximo nó uma vez por linha.

### Executar
Clique em **Executar**. O nó conectado é executado uma vez para cada linha, da primeira à última, e guarda um resultado por linha.

Workflow: Uma Lista com três prompts executa o Gerar imagem três vezes, e o Escolher o melhor fica com a mais forte das três imagens.

- Lista → Gerar imagem (prompt · Cada item)
- Gerar imagem → Escolher o melhor (candidatos)

## Entradas e saídas
| Entrada ou saída | O que faz |
| --- | --- |
| **+** (canto inferior esquerdo) | Conecte qualquer nó aqui para adicionar uma nova coluna que recebe os valores desse nó. Cada conexão adiciona uma coluna tipada. |
| Entradas das colunas | Cada coluna tem a própria entrada, à esquerda. Uma coluna com uma conexão mostra os valores que o nó anterior produz. |
| Saídas das colunas | Cada coluna tem a própria saída, à direita. Em uma lista de uma coluna, a saída envia os itens ao próximo nó um a um. |

## Configurações
O painel de configurações tem duas abas. **Configurar** guarda as linhas e as opções abaixo. **Dados** mostra as linhas exatamente como serão executadas, incluindo os valores que vêm de nós conectados.

| Configuração | O que faz |
| --- | --- |
| **Lista** ou **Tabela** | As linhas. O painel mostra o editor **Lista**, de uma coluna, e passa para o editor **Tabela** quando o nó tem mais de uma coluna. |
| Tipo da coluna | Cada coluna é **Texto**, **Imagem**, **Vídeo**, **Áudio** ou **JSON**. Defina o tipo de acordo com o conteúdo: uma célula de mídia mostra uma miniatura ou um player, e a entrada e a saída da coluna aceitam esse tipo. |
| **Adicionar coluna** | Adiciona uma coluna de texto. Ela aparece no editor **Tabela**. |
| Delimitador e **Dividir** | Em uma coluna de texto, escolha **Vírgula**, **Barra vertical**, **Ponto e vírgula**, **Quebra de linha**, **Três asteriscos (\*\*\*)** ou **Personalizado** e clique em **Dividir** para transformar cada célula em várias linhas. Colar em uma célula um texto que contém o delimitador escolhido divide a célula do mesmo jeito. |
| **Modo de exibição** | Como o nó aparece no canvas: **Lista (linhas)**, **Galeria (grade)** ou **Compacto (tudo visível)**. O nó escolhe um modo a partir dos tipos das colunas, até você escolher. |
| **Itens por linha** | Em **Galeria (grade)**, o número de itens em cada linha, de 1 a 6. O padrão é 3. |
| **Máx. de linhas de texto** | Quantas linhas cada item de texto mostra no nó, de 1 a 20. O padrão é 3. |
| **Tamanho da fonte** | **Pequeno**, **Médio** ou **Grande**. O padrão é **Médio**. |

No canvas, o pequeno botão de tabela sob o nó alterna entre um resumo curto, como “3 linhas × 2 colunas”, e a tabela ou a galeria completa. Uma tabela com imagens, vídeos ou áudio abre na visualização completa. O botão só muda a exibição e nunca executa nada.

### Quando a Lista é uma entrada de app
Quando você publica o workflow como um [app](https://nodaro.ai/docs/concepts/apps), as pessoas que usam o app podem adicionar e remover linhas. Três configurações em **Modo apresentação / app** controlam isso:

| Configuração | O que faz |
| --- | --- |
| **Máx. de itens** | O máximo de linhas que um usuário do app pode adicionar, de 1 a 20. O padrão é 10. |
| **Mín. de linhas para executar** | O botão **Executar** do app fica desativado até o usuário adicionar esse número de linhas. 0 significa sem mínimo. |
| **Linhas padrão** | Quantas linhas vazias o app mostra quando carrega pela primeira vez. O padrão é 1. |

## Transformar uma lista em tabela
Uma coluna basta quando só o prompt muda. Quando cada execução precisa de um segundo valor, adicione uma coluna:

1. Conecte um nó à entrada **+**, no canto inferior esquerdo da Lista. Uma nova coluna aparece, com o tipo desse nó.
2. Defina o tipo de cada coluna no painel de configurações, por exemplo **Imagem** para uma coluna de imagens de referência.
3. Conecte a saída de cada coluna a uma entrada diferente do próximo nó, por exemplo uma coluna a **Prompt** e outra a **Negativo**.

## Como as linhas se combinam
Quando duas ou mais colunas alimentam o mesmo nó, o nó é executado uma vez por linha, e cada entrada recebe o valor daquela linha.

- **A linha 3 continua sendo a linha 3.** Uma célula vazia não passa nada para a entrada dela naquela execução. A célula vazia nunca faz as linhas de baixo subirem.
- **Uma linha é executada quando qualquer célula dela tem valor.** Uma linha vazia em todas as colunas é ignorada, então a linha em branco do final da tabela nunca acrescenta uma execução.
- **A ordem das conexões não importa.** A coluna conectada à entrada **Prompt** fornece o prompt. Uma coluna conectada a **Negativo** ou a outra entrada secundária nunca é usada como prompt.
- **O prompt da linha substitui o prompt digitado.** O valor da linha substitui o prompt digitado no próximo nó; ele não é adicionado a esse prompt. Quando a célula de prompt da linha está vazia, o prompt digitado é usado.
- **Repetir repete a linha.** Com **Repetir** definido como 2 no próximo nó, cada linha é executada duas vezes com os mesmos valores.

Listas com números de linhas diferentes não são combinadas linha a linha. A lista mais longa define o número de execuções, e a lista mais curta recomeça da primeira linha quando acaba. O mesmo acontece quando só uma de duas conexões de coluna tem um filtro de item ou de intervalo, porque o filtro muda o número de linhas daquela conexão.

Só uma conexão no modo **Cada item** executa o próximo nó uma vez por linha. Uma conexão no modo **Conjunto** passa a lista inteira em uma única execução. Leia [Listas e lotes](https://nodaro.ai/docs/concepts/lists-and-batching) para ver todos os modos de conexão.

## Créditos
O nó Lista é gratuito. Cada nó executado uma vez por linha é cobrado uma vez por linha. O custo de um lote é o preço do nó multiplicado pelo número de linhas. A estimativa de créditos no próximo nó já inclui essa multiplicação, então confira-a antes de uma execução grande.

## Lista, Coletar ou Escolher o melhor
- **A Lista distribui o trabalho.** Uma só origem de linhas, e o próximo nó é executado uma vez para cada linha.
- **[Coletar](https://nodaro.ai/docs/nodes/automate/collect) (Collect) reúne os resultados.** Vários nós separados se conectam a ele, e ele repassa os resultados deles juntos.
- **[Escolher o melhor](https://nodaro.ai/docs/nodes/automate/choose-best) (Choose Best) decide.** Ele transforma muitos resultados em um, por exemplo a melhor imagem do lote.

Os três se encadeiam em um padrão comum: distribuir com a Lista, reunir com o Coletar ou diretamente, e decidir com o Escolher o melhor.

## Dicas
- **Uma ideia por linha.** Cada linha deve ser um prompt ou um valor completo, que funcione sozinho.
- **Adicione uma coluna só quando precisar.** Uma segunda coluna é útil quando uma segunda entrada muda a cada execução. Fora isso, mantenha uma coluna.
- **Defina o tipo de cada coluna.** Uma coluna do tipo **Imagem**, **Vídeo** ou **Áudio** mostra a mídia e se conecta às entradas certas.
- **Divida lotes grandes.** As linhas são executadas uma depois da outra, então uma lista longa demora mais para terminar. Várias listas menores são mais fáceis de conferir.
- **Nós Table antigos.** Um workflow salvo com um nó Table o abre como uma Lista, com as mesmas colunas e linhas.

## Frequently asked questions

### Como gero uma imagem por prompt no Nodaro?

Adicione um nó “Lista”, digite um prompt por linha e conecte-o à entrada “Prompt” do “Gerar imagem”. A conexão fica no modo “Cada item”, então o “Gerar imagem” é executado uma vez por linha e guarda um resultado por linha.

### O nó “Lista” custa créditos?

Não. O nó “Lista” não chama nenhum modelo e é gratuito. Você paga pelos nós que são executados uma vez por linha, então 10 linhas em um nó que custa 20 créditos por execução custam 200 créditos.

### Como mudo dois valores por execução, como o prompt e o prompt negativo?

Transforme a lista em uma tabela. Conecte um nó à entrada “+”, no canto inferior esquerdo da “Lista”, para adicionar uma coluna. Depois, conecte cada coluna a uma entrada própria do próximo nó. Cada execução pega todos os valores da mesma linha.

### O que acontece quando uma linha tem uma célula vazia?

A linha mantém a posição, e a entrada alimentada por aquela coluna não recebe nada naquela execução. Uma linha vazia em todas as colunas não é executada.

### O que aconteceu com o nó “Table”?

O nó “Table” foi incorporado à “Lista”. Um workflow salvo que contém um nó “Table” o abre como uma “Lista” e continua funcionando sem alterações.