# 목록

> 프롬프트 목록을 입력하거나 붙여 넣거나, 열이 여러 개인 표를 만들면 연결된 모든 노드가 행마다 한 번씩 실행됩니다. 목록 노드 자체는 무료입니다.

Source: https://nodaro.ai/ko/docs/nodes/automate/list

**목록** 노드는 값의 목록을 담으며, 여기에 연결된 모든 노드가 행마다 한 번씩 실행됩니다. 한 행에 프롬프트를 하나씩 입력하거나 붙여 넣으면, 한 번의 실행으로 이미지, 동영상, 보이스오버를 일괄로 만들 수 있습니다. 목록 노드는 모델을 호출하지 않으며 크레딧이 들지 않습니다.

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

## 사용 시기
- 프롬프트가 10개 있고, 프롬프트마다 이미지를 한 장씩 만들고 싶을 때.
- 같은 동영상 워크플로를 여러 피사체나 제품에 대해 실행하고 싶을 때.
- [텍스트 음성 변환](https://nodaro.ai/docs/nodes/audio/text-to-speech)으로 스크립트의 모든 줄에 보이스오버를 만들고 싶을 때.
- 동영상마다 프롬프트와 레퍼런스 사진이 필요한 것처럼, 실행마다 값이 두 개 이상 필요할 때. 값마다 열이 하나씩 있는 표로 목록을 늘리세요.

## 빠른 시작
### 노드 추가
캔버스에서 Tab 키를 누르고 **자동화 › 목록 및 일괄 처리 › 목록**을 선택하세요.

### 행 추가
설정 패널을 열고 한 행에 값을 하나씩 입력하세요. 다음 행을 추가하려면 **행 추가**를 클릭하거나 Enter 키를 누르세요. 행을 옮기려면 핸들을 잡고 끄세요.

### 연결
목록의 출력에서 실행마다 바뀌어야 할 입력으로 끌어 연결하세요. 예를 들어 [이미지 생성](https://nodaro.ai/docs/nodes/image/generate-image)의 **프롬프트** 입력에 연결합니다. 목록에서 나가는 연결은 **개별**로 설정되며, 다음 노드를 행마다 한 번씩 실행합니다.

### 실행
**실행**을 클릭하세요. 연결된 노드가 맨 위 행부터 맨 아래 행까지 행마다 한 번씩 실행되고, 행마다 결과 하나를 보관합니다.

Workflow: 프롬프트 3개가 든 목록이 이미지 생성을 세 번 실행하고, 최적 선택이 이미지 세 장 중 가장 좋은 것을 남깁니다.

- 목록 → 이미지 생성 (프롬프트 · 개별)
- 이미지 생성 → 최적 선택 (후보)

## 입력과 출력
| 입력 또는 출력 | 하는 일 |
| --- | --- |
| **+**(왼쪽 아래) | 여기에 아무 노드나 연결하면 그 노드에서 값을 가져오는 새 열이 추가됩니다. 연결 하나마다 유형이 정해진 열이 하나 추가됩니다. |
| 열 입력 | 모든 열에는 왼쪽에 자체 입력이 있습니다. 연결된 열에는 업스트림 노드가 만든 값이 표시됩니다. |
| 열 출력 | 모든 열에는 오른쪽에 자체 출력이 있습니다. 열이 하나인 목록에서는 출력이 항목을 다음 노드로 하나씩 보냅니다. |

## 설정
설정 패널에는 탭이 두 개 있습니다. **구성**에는 행과 아래 옵션이 있습니다. **데이터**는 연결된 노드에서 오는 값을 포함해, 실행될 행을 그대로 보여 줍니다.

| 설정 | 하는 일 |
| --- | --- |
| **목록** 또는 **표** | 행입니다. 패널에는 열이 하나인 **목록** 편집기가 표시되며, 노드에 열이 두 개 이상 생기면 **표** 편집기로 바뀝니다. |
| 열 유형 | 각 열은 **텍스트**, **이미지**, **동영상**, **오디오**, **JSON** 중 하나입니다. 내용에 맞게 정하세요. 미디어 셀에는 섬네일이나 플레이어가 표시되며, 열의 입력과 출력이 그 유형을 받습니다. |
| **열 추가** | 텍스트 열을 추가합니다. **표** 편집기에 나타납니다. |
| 구분자와 **분할** | 텍스트 열에서 **쉼표**, **파이프**, **세미콜론**, **줄바꿈**, **별표 3개(\*\*\*)**, **사용자 지정** 중 하나를 고른 다음 **분할**을 클릭하면 각 셀이 여러 행으로 나뉩니다. 고른 구분자가 들어 있는 텍스트를 셀에 붙여 넣어도 같은 방식으로 나뉩니다. |
| **보기 모드** | 캔버스에서 노드가 보이는 방식입니다. **목록(행)**, **갤러리(그리드)**, **촘촘하게(모두 맞춤)** 중 하나입니다. 직접 고르기 전까지는 노드가 열 유형에 따라 하나를 고릅니다. |
| **행당 항목 수** | <strong>갤러리(그리드)</strong>에서 각 행의 항목 수이며, 1~6입니다. 기본값은 3입니다. |
| **텍스트 최대 줄 수** | 노드에서 각 텍스트 항목이 보여 주는 줄 수이며, 1~20입니다. 기본값은 3입니다. |
| **글꼴 크기** | **작게**, **중간**, **크게** 중 하나입니다. 기본값은 **중간**입니다. |

캔버스에서 노드 아래의 작은 표 버튼을 누르면 “3행 × 2열” 같은 짧은 요약과 전체 표나 갤러리 사이를 전환합니다. 사진, 동영상, 오디오가 든 표는 전체 보기로 열립니다. 이 버튼은 표시만 바꾸며 아무것도 실행하지 않습니다.

### 목록이 앱 입력일 때
워크플로를 [앱](https://nodaro.ai/docs/concepts/apps)으로 게시하면, 앱을 사용하는 사람이 직접 행을 추가하고 삭제할 수 있습니다. **프레젠테이션/앱 모드** 아래의 설정 세 가지가 이를 제어합니다.

| 설정 | 하는 일 |
| --- | --- |
| **최대 항목 수** | 앱 사용자가 추가할 수 있는 최대 행 수이며, 1~20입니다. 기본값은 10입니다. |
| **실행에 필요한 최소 행 수** | 사용자가 이만큼 행을 추가할 때까지 앱의 **실행** 버튼이 비활성화됩니다. 0은 최소 개수가 없다는 뜻입니다. |
| **기본 행 수** | 앱을 처음 불러올 때 표시되는 빈 행의 수입니다. 기본값은 1입니다. |

## 목록을 표로 늘리기
프롬프트만 바뀐다면 열 하나로 충분합니다. 실행마다 두 번째 값이 필요하면 열을 추가하세요.

1. 목록 왼쪽 아래의 **+** 입력에 노드를 연결하세요. 그 노드에 맞는 유형의 새 열이 나타납니다.
2. 설정 패널에서 각 열의 유형을 정하세요. 예를 들어 레퍼런스 사진 열은 **이미지**로 정합니다.
3. 각 열의 출력을 다음 노드의 서로 다른 입력에 연결하세요. 예를 들어 한 열은 **프롬프트**에, 다른 열은 **네거티브**에 연결합니다.

## 행이 짝을 이루는 방식
열 두 개 이상이 같은 노드로 들어가면, 노드는 행마다 한 번씩 실행되고 모든 입력은 그 행에서 값을 받습니다.

- **3행은 항상 3행입니다.** 빈 셀은 그 실행에서 해당 입력에 아무것도 주지 않습니다. 빈 셀 때문에 아래 행이 위로 당겨지지 않습니다.
- **셀 하나라도 값이 있으면 행이 실행됩니다.** 모든 열이 비어 있는 행은 무시되므로, 표 맨 아래의 빈 행이 실행을 늘리지 않습니다.
- **연결 순서는 중요하지 않습니다.** **프롬프트** 입력에 연결된 열이 프롬프트를 제공합니다. **네거티브**나 다른 보조 입력에 연결된 열은 프롬프트로 쓰이지 않습니다.
- **행의 프롬프트가 입력한 프롬프트를 대체합니다.** 행의 값은 다음 노드에 입력한 프롬프트를 대체하며, 그 프롬프트에 더해지지 않습니다. 행의 프롬프트 셀이 비어 있으면 입력한 프롬프트가 사용됩니다.
- **반복은 행을 반복합니다.** 다음 노드의 **반복**을 2로 정하면 각 행이 같은 값으로 두 번 실행됩니다.

행 수가 다른 목록은 행 단위로 짝지어지지 않습니다. 더 긴 목록이 실행 횟수를 정하고, 더 짧은 목록은 항목이 바닥나면 첫 행부터 다시 시작합니다. 열 연결 두 개 중 하나에만 항목 필터나 범위 필터가 있을 때도 마찬가지입니다. 필터가 그 연결의 행 수를 바꾸기 때문입니다.

**개별** 모드의 연결만 다음 노드를 행마다 한 번씩 실행합니다. **묶음**으로 설정한 연결은 목록 전체를 한 번의 실행으로 넘깁니다. 모든 연결 모드는 [목록과 일괄 처리](https://nodaro.ai/docs/concepts/lists-and-batching)에서 확인하세요.

## 크레딧
목록 노드는 무료입니다. 행마다 한 번씩 실행되는 노드는 행마다 한 번씩 요금이 청구됩니다. 일괄 처리의 비용은 노드 가격에 행 수를 곱한 값입니다. 다음 노드의 크레딧 예상치에는 이 곱셈이 이미 반영되어 있으므로, 큰 실행 전에 확인하세요.

## 목록, 수집, 최적 선택
- **목록은 작업을 펼칩니다.** 행의 출처는 하나이며, 다음 노드가 행마다 한 번씩 실행됩니다.
- **[수집](https://nodaro.ai/docs/nodes/automate/collect)은 결과를 모읍니다.** 따로 떨어진 여러 노드가 여기에 연결되고, 수집이 그 결과를 함께 넘깁니다.
- **[최적 선택](https://nodaro.ai/docs/nodes/automate/choose-best)은 결정합니다.** 많은 결과를 하나로 만듭니다. 예를 들어 일괄 처리에서 가장 좋은 이미지를 고릅니다.

세 노드는 흔히 쓰는 패턴으로 이어집니다. 목록으로 펼치고, 수집으로 또는 직접 모으고, 최적 선택으로 결정합니다.

## 팁
- **한 행에 아이디어 하나.** 각 행은 그 자체로 작동하는 완전한 프롬프트나 값이어야 합니다.
- **필요할 때만 열을 추가하세요.** 두 번째 열은 두 번째 입력이 실행마다 바뀔 때 유용합니다. 그렇지 않다면 열 하나를 유지하세요.
- **모든 열에 유형을 정하세요.** **이미지**, **동영상**, **오디오** 유형의 열은 미디어를 보여 주고 알맞은 입력에 연결됩니다.
- **큰 일괄 처리는 나누세요.** 행은 차례로 실행되므로 긴 목록은 끝나기까지 오래 걸립니다. 작은 목록 여러 개가 확인하기 더 쉽습니다.
- **예전 표 노드.** 표 노드가 든 저장된 워크플로는 그 노드를 같은 열과 행을 가진 목록으로 엽니다.

## 자주 묻는 질문

### Nodaro에서 프롬프트마다 이미지를 한 장씩 만들려면 어떻게 하나요?

목록 노드를 추가하고 한 행에 프롬프트를 하나씩 입력한 다음, 이미지 생성의 “프롬프트” 입력에 연결하세요. 연결이 “개별”로 설정되므로 이미지 생성이 행마다 한 번씩 실행되어 행마다 결과 하나를 보관합니다.

### 목록 노드에 크레딧이 드나요?

아니요. 목록 노드는 모델을 호출하지 않으며 무료입니다. 행마다 한 번씩 실행되는 노드의 비용을 내므로, 실행당 20크레딧인 노드에 행 10개를 넣으면 200크레딧이 듭니다.

### 프롬프트와 네거티브 프롬프트처럼 실행마다 값 두 개를 바꾸려면 어떻게 하나요?

목록을 표로 늘리세요. 목록 왼쪽 아래의 + 입력에 노드를 연결하면 열이 추가됩니다. 그런 다음 각 열을 다음 노드의 서로 다른 입력에 연결하세요. 각 실행은 모든 값을 같은 행에서 가져옵니다.

### 행에 빈 셀이 있으면 어떻게 되나요?

행은 제자리를 유지하며, 그 열이 연결된 입력은 해당 실행에서 아무것도 받지 않습니다. 모든 열이 비어 있는 행은 아예 실행되지 않습니다.

### 표 노드는 어떻게 되었나요?

표 노드는 목록에 통합되었습니다. 표 노드가 들어 있는 저장된 워크플로는 그 노드를 목록으로 열며, 변경 없이 계속 작동합니다.