목록 하나로 뒤를 여러 번 실행하기

프롬프트 변수 하나에 값을 하나씩 손으로 바꿔 가며 실행하면 장면 열 개를 만드는 데 프롬프트를 열 번 써야 합니다. Text Iterator는 그 반복을 목록 하나로 대신합니다.

Text Iterator가 하는 일 — 정확히 뭐가 반복되나

발표자의 설명을 그대로 옮기면, “텍스트 반복 노드(Text Iterator)는 항목 몇 개를 받아서 동시에 실행할 수 있게 해 줍니다. Iterator가 연결되면, 이 워크플로우에서 그 뒤에 있는 모든 것들이 같은 횟수만큼 실행됩니다.”

반복되는 대상은 Iterator가 연결된 자리 뒤쪽 전체입니다. 이 카드에서는 프롬프트 변수 → 이미지 모델로 연결된 체인이 있으므로 Text Iterator에 항목 4개를 넣으면 이미지 모델이 4번 실행돼 이미지 4장이 나옵니다. 그 뒤에 영상 모델까지 연결돼 있었다면 영상도 4개 나왔을 것입니다.

이 원리는 앞 카드(프롬프트 변수)와 짝을 이룹니다. 변수가 “바뀔 자리를 미리 표시해 두는 것”이라면, Iterator는 “그 자리에 넣을 값을 목록으로 준비해 두는 것”입니다. 두 카드를 합치면 프롬프트를 손으로 열 번 다시 쓰지 않고도 장면 열 개를 만들 수 있습니다.

화면으로 따라가기

목록의 각 문구가 변수 자리에 들어가 뒤쪽 노드를 반복 실행하는 연결을 확인합니다.

Text Iterator 노드 안에 문구가 한 줄씩 담겨 있고 오른쪽으로 뻗은 Text 출력선이 Prompt Variables 노드의 변수 자리에 연결돼 있습니다.

Pitfall

• Iterator를 캔버스에 놓기만 하고 변수 포트에 연결하지 않으면 반복이 일어나지 않습니다. 이전 카드의 변수 자리에 정확히 꽂혀 있는지 확인합니다.
• Image Iterator에 다른 노드의 출력을 바로 연결하려고 하면 안 됩니다. 입력 포트가 없어서, 중간 결과를 파일로 내려받아 다시 끌어와야 합니다.

자주 묻는 질문

• 항목을 몇 개까지 넣을 수 있나요? — 화면 우측 상단에 “3/50”처럼 표시됩니다. 이 예시 기준 최대 50개까지 넣을 수 있습니다.
• Text Iterator와 Image Iterator·Video Iterator는 같은 노드인가요? — 원리(목록 → 반복 실행)는 같지만 담는 데이터 종류가 달라 별도 노드입니다. 자세한 차이는 공식 문서: Iterators에서 볼 수 있습니다.
• 크레딧이 갑자기 많이 빠졌습니다. — Iterator는 항목 수만큼 뒤쪽 실행이 곱해집니다. 큰 배치를 돌리기 전 2~3개로 먼저 테스트합니다.