# 이미지 콜라주

> 최대 30개의 이미지를 스마트 또는 그리드 레이아웃으로 2K나 4K 이미지 한 장에 배치하세요. 번호와 레이블을 붙이면 여러 샷이 스토리보드가 됩니다.

Source: https://nodaro.ai/ko/docs/nodes/image/image-collage

**이미지 콜라주** 노드는 여러 이미지를 큰 이미지 한 장에 배치합니다. 이미지 2~30개 또는 이미지 URL 목록을 연결하고, 스마트 또는 그리드 레이아웃을 선택하세요. 노드는 2K 또는 4K 이미지 한 장을 반환합니다. 이미지는 절대 잘리지 않으며, 모든 이미지가 전체 모습 그대로 표시됩니다.

- Found in: Image › Edit & Retouch
- Output: image
- API type: `image-collage`

## 사용 시기
- [이미지 생성](https://nodaro.ai/docs/nodes/image/generate-image)의 여러 결과로 무드 보드나 콘택트 시트를 만듭니다.
- 여러 제품 사진을 이미지 한 장으로 합쳐 소셜 게시물에 사용합니다.
- 비포와 애프터, 같은 프롬프트로 여러 번 생성한 결과 같은 변형을 나란히 비교합니다.
- 각 샷에 레이블을 붙인 번호 매긴 스토리보드를 구성합니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab 키를 누르고 **이미지 › 편집 및 보정 › 이미지 콜라주**를 선택하세요.

### 이미지 연결
각 이미지 노드에서 **이미지** 입력으로 드래그하세요. 모든 이미지는 같은 입력에 연결되며, 처음 연결한 이미지가 왼쪽 위에 배치됩니다. 여러 이미지를 한꺼번에 콜라주하려면 대신 이미지 URL [목록](https://nodaro.ai/docs/nodes/automate/list)을 연결하세요.

### 레이아웃과 크기 선택
설정 패널을 여세요. **레이아웃**, **화면 비율**, **해상도**를 선택하세요. 연결된 이미지의 행을 드래그해 읽는 순서를 정하세요.

### 실행
노드에서 **실행**을 클릭하세요. 콜라주가 노드에 나타나고, 이전의 모든 실행 결과도 버전으로 남습니다.

Workflow: 생성한 샷 3개가 번호 매긴 스토리보드 시트 한 장이 됩니다.

- 이미지 생성 → 이미지 콜라주 (이미지)
- 이미지 생성 → 이미지 콜라주 (이미지)
- 이미지 생성 → 이미지 콜라주 (이미지)

## 입력
| 입력 | 받는 노드 | 기능 |
| --- | --- | --- |
| **이미지** | 이미지 생성, 이미지 업로드, 이미지 수정 같은 이미지 노드 또는 이미지 URL 목록 | 배치할 이미지입니다. 이미지 2~30개를 모두 이 입력 하나에 연결합니다. 필수입니다. |

출력인 **이미지**는 완성된 콜라주 PNG입니다.

## 설정
| 설정 | 기능 |
| --- | --- |
| **레이아웃** | 기본값인 <strong>스마트(양쪽 정렬 — 비율 고려)</strong>는 각 이미지의 모양을 그대로 유지하는 행에 이미지를 채워 넣습니다. <strong>그리드(균일한 셀)</strong>는 모든 이미지를 같은 크기의 셀에 넣습니다. [스마트 또는 그리드](#smart-or-grid)를 참조하세요. |
| **이미지에 번호 매기기(스토리보드)** | 기본값은 꺼짐입니다. 켜면 콜라주의 읽는 순서대로 이미지에 1, 2, 3을 표시합니다. |
| **배지 위치** | 각 이미지에서 번호와 레이블이 놓이는 위치입니다. 기본값인 **왼쪽 위(스토리보드 관례)** 또는 **오른쪽 위** 중 하나입니다. **오른쪽 위**를 선택하면 중앙보다 왼쪽에 배치된 피사체에 배지가 겹치지 않습니다. |
| 연결된 이미지 | 연결된 모든 입력이 썸네일과 함께 표시됩니다. 행을 드래그해 읽는 순서를 정하세요. 맨 위 행이 첫 번째가 되어 왼쪽 위에 배치됩니다. |
| 크기(이미지별) | **자동**, **크게**, **중간**, **작게** 중 하나입니다. 스마트 레이아웃용 상대적인 힌트로, 크게는 중간의 약 2배, 작게는 약 절반 크기입니다. 그리드 레이아웃에서는 무시됩니다. |
| **레이블(선택 사항)** | 입력별 캡션으로, “3 · 클로즈업”처럼 번호 뒤에 표시됩니다. 최대 80자입니다. 이미지에 비해 너무 긴 레이블은 말줄임표로 줄어듭니다. |
| **화면 비율** | `1:1`, `4:3`(기본값), `3:2`, `16:9`, `21:9`, `4:5`, `3:4`, `2:3`, `9:16` 중 하나입니다. 그리드에서는 정확한 출력 모양이 되고, 스마트에서는 목표 모양이 됩니다. |
| **해상도** | 기본값인 **4K**(긴 변 3840px) 또는 **2K**(긴 변 2560px)입니다. |
| **간격** | 이미지 사이와 가장자리 둘레의 여백으로, 단위는 픽셀이며 0~200입니다. 기본값은 24입니다. |
| **배경 색상** | 여백의 색상입니다. 그리드에서는 셀을 다 채우지 못한 이미지 주위의 색상이기도 합니다. 기본값은 흰색입니다. |

목록 입력은 연결된 이미지 목록에서 한 덩어리로 움직입니다. 그 크기와 레이블은 목록이 넣는 모든 이미지에 적용됩니다.

노드 자체에도 **번호** 컨트롤이 있으며, **없음**, **왼쪽 위**, **오른쪽 위** 중에서 고를 수 있습니다. **없음**을 선택하면 번호가 사라지고, 레이블은 원래 모서리에 남습니다.

## 스마트 또는 그리드
| | 스마트 | 그리드 |
| --- | --- | --- |
| 배치 | 높이가 서로 다른 행이 쌓이고, 각 행은 가장자리부터 가장자리까지 채워집니다 | 같은 크기의 셀이 행과 열로 놓이며, 다 채워지지 않은 마지막 행은 가운데에 정렬됩니다 |
| 이미지 모양 | 각 셀이 이미지와 정확히 같은 모양입니다 | 각 이미지가 셀 안에 맞춰지고, 주위를 배경 색상이 채웁니다 |
| 출력 크기 | 너비는 설정을 따르고, 높이는 행에 맞춰 달라집니다 | 설정한 해상도와 화면 비율 그대로입니다 |
| 크기 힌트 | 사용됩니다 | 무시됩니다 |
| 적합한 용도 | 세로와 가로가 섞인 이미지, 히어로 레이아웃 | 피드와 슬라이드용의 깔끔하고 균일한 타일 |

그리드에서 캔버스는 선택한 해상도와 비율 그대로입니다. 4K의 `16:9`는 3840 × 2160픽셀이고, 2K의 `1:1`은 2560 × 2560픽셀입니다. 열 수는 이미지 개수의 제곱근을 올림한 값이므로, 이미지 9개는 3열, 10개는 4열이 됩니다.

스마트에서는 이미지가 잘리지 않도록 콜라주의 높이가 달라집니다. 높이는 목표 긴 변의 2배를 넘지 않습니다. 이미지가 들어가지 않을 때는 자르지 않고 모든 이미지를 고르게 축소합니다. 목표 모양이 넓을수록 행은 더 적고 더 높아집니다.

## 크레딧
| 해상도 | 크레딧 |
| --- | --- |
| 2K | 22 |
| 4K | 44 |

가격은 이미지 개수와 관계가 없습니다. 번호와 레이블도 가격을 바꾸지 않습니다.

## 팁
- **모양이 섞여 있으면 스마트를 선택하세요.** 세로 이미지와 가로 이미지가 잘림도, 낭비되는 공간도 없이 행에 채워집니다.
- **히어로 이미지를 만드세요.** 이미지 하나를 **크게**로 설정하면 그 이미지가 단독으로 높은 행을 차지하기 쉽습니다. 크기 힌트는 이미지가 5개 이상일 때 가장 잘 드러나며, 히어로 이미지를 **크게**, 나머지를 **작게**로 설정하면 대비가 가장 강해집니다.
- **모두 같은 크기면 달라지는 것이 없습니다.** 모든 이미지를 **크게**로 설정해도 모두 **자동**으로 설정한 것과 같습니다. 힌트는 이미지 사이의 비율이기 때문입니다.
- **그리드에서는 비율을 게시할 곳에 맞추세요.** 소셜 피드에는 `1:1`이나 `4:5`, 슬라이드와 썸네일에는 `16:9`, 스토리와 릴스에는 `9:16`을 사용하세요.
- **액자처럼 또는 타일처럼 만드세요.** 갤러리 느낌을 원하면 **간격**을 늘리고, 가장자리까지 이어진 모자이크를 원하면 `0`으로 설정하세요.
- **화면용이면 2K를 선택하세요.** 화면에서 볼 때는 2K로 충분하고 비용도 적습니다. 인쇄나 대형 디스플레이에는 4K를 선택하세요.
- **드래그로 번호를 다시 매기세요.** 번호는 연결한 순서가 아니라 최종 읽는 순서를 따릅니다.

## API에서 사용
`POST /v1/image-collage`는 노드와 같은 설정을 받습니다.

| 필드 | 설정하는 내용 |
| --- | --- |
| `imageUrls` | 읽는 순서대로 나열한 이미지입니다. 필수입니다. |
| `layout` | `smart` 또는 `grid`입니다. |
| `resolution` | `2K` 또는 `4K`입니다. |
| `aspectRatio` | 편집기에 있는 비율뿐 아니라 모든 `W:H` 비율입니다. |
| `gap`, `backgroundColor` | 픽셀 단위의 간격과 배경 색상입니다. |
| `imageSizes` | 이미지별 힌트로, `imageUrls`와 같은 순서입니다. `0`은 자동, `1`은 크게, `2`는 중간, `3`은 작게입니다. |
| `numbered`, `badgePosition` | 번호를 켜고, 배지를 `top-left` 또는 `top-right`에 놓습니다. |
| `imageLabels` | 이미지별 레이블로, `imageUrls`와 같은 순서입니다. 레이블이 없으면 `null`이나 빈 문자열을 사용하세요. |

이 라우트는 `attachToCharacterId`, `boards`로 설정한 `attachToColumn`, `attachName`, `attachBoardType`을 사용해 완성된 콜라주를 캐릭터의 보드에 첨부할 수도 있습니다. 첨부해도 가격은 바뀌지 않습니다.

## 자주 묻는 질문

### 이미지 콜라주로 이미지를 몇 개까지 합칠 수 있나요?

2~30개입니다. 각각의 이미지 노드에서 연결하거나, 이미지 URL 목록에서 연결할 수 있습니다.

### 이미지 콜라주가 이미지를 잘라내나요?

아니요. 스마트 레이아웃은 각 셀을 이미지의 모양에 정확히 맞추고, 그리드 레이아웃은 각 이미지를 셀 안에 맞춰 넣고 주위를 배경 색상으로 채웁니다. 잘리거나 늘어나는 이미지는 없습니다.

### 이미지 콜라주는 몇 크레딧인가요?

2K는 22크레딧, 4K는 44크레딧입니다. 이미지 개수는 가격에 영향을 주지 않습니다.

### 이미지 콜라주로 스토리보드를 만들려면 어떻게 하나요?

이미지에 번호 매기기(스토리보드)를 켜면 읽는 순서대로 샷에 1, 2, 3이 표시됩니다. 각 입력에는 클로즈업 같은 레이블을 붙이세요. 그러면 각 배지가 “3 · 클로즈업”처럼 표시됩니다.

### 스마트 콜라주가 선택한 화면 비율과 정확히 같지 않은 이유는 무엇인가요?

스마트 레이아웃에서 화면 비율은 목표 모양입니다. 각 행이 이미지 본래의 모양을 유지하므로 최종 높이가 달라집니다. 정확한 비율이 필요하면 그리드 레이아웃을 사용하세요.