> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDanceSeedreamNodeV3 - ComfyUI Built-in Node Documentation

> ByteDance Seedream 4.5 & 5.0은 텍스트 프롬프트에서 이미지를 생성하거나(텍스트-이미지), 선택적 참조 이미지를 가이드로 사용하여 이미지를 생성/편집합니다.

ByteDance Seedream 4.5 & 5.0은 텍스트 프롬프트에서 이미지를 생성하거나(텍스트-이미지), 선택적 참조 이미지를 가이드로 사용하여 이미지를 생성/편집합니다. ByteDance Seedream 4.0, 4.5, 5.0 모델을 최대 4K 해상도로 지원합니다. 이 노드는 프롬프트와 참조 이미지를 ByteDance API로 전송하고, 생성 작업이 완료될 때까지 대기한 후 결과 이미지 텐서를 반환합니다.

## 입력

### 공통 입력

| 매개변수   | 설명                                                              | 데이터 타입         | 필수 | 범위                                                                                                |
| ------ | --------------------------------------------------------------- | -------------- | -- | ------------------------------------------------------------------------------------------------- |
| `프롬프트` | 이미지를 생성하거나 편집하기 위한 텍스트 프롬프트입니다. 앞뒤 공백을 제거한 후 비어 있으면 안 됩니다.      | STRING         | 예  | 여러 줄 텍스트                                                                                          |
| `모델`   | 사용할 Seedream 모델을 선택합니다. 각 모델은 아래에 고유한 하위 매개변수 집합과 제한 사항을 제공합니다. | DYNAMIC\_COMBO | 예  | "seedream 5.0 pro"<br />"seedream 5.0 lite"<br />"seedream-4-5-251128"<br />"seedream-4-0-250828" |

### Seedream 5.0 Pro 입력 (seedream 5.0 pro)

| 매개변수                  | 설명                                                                                                                                                                   | 데이터 타입  | 필수  | 범위                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | --------------------------- |
| `size_preset`         | 권장 크기를 선택합니다. 아래의 너비와 높이를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋.                                                                                               | COMBO   | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width`               | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 3136 (step 2)       |
| `height`              | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 2496 (step 2)       |
| `prompt_optimization` | 참조 이미지가 제공될 때의 프롬프트 최적화 모드입니다. 'standard'는 더 높은 품질을, 'fast'는 더 짧은 생성 시간을 제공합니다. 기본값: "standard".                                                                     | COMBO   | 아니요 | "standard"<br />"fast"      |
| `seed`                | 생성에 사용할 시드입니다. 기본값: 42.                                                                                                                                              | INT     | 아니요 | 0 \~ 2147483647             |
| `watermark`           | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false.                                                                                                                    | BOOLEAN | 아니요 | true / false                |
| `thinking`            | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 특히 Seedream 5.0 Pro에서 생성 시간이 크게 늘어날 수 있습니다. 텍스트-이미지 생성에서만 비활성화할 수 있으며, 참조 이미지가 제공되는 경우에는 비활성화할 수 없습니다. 기본값: true. | BOOLEAN | 아니요 | true / false                |

### Seedream 5.0 Lite 입력 (seedream 5.0 lite)

| 매개변수              | 설명                                                                                                                                                                   | 데이터 타입  | 필수  | 범위                          |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | --------------------------- |
| `size_preset`     | 권장 크기를 선택합니다. 아래의 너비와 높이를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋.                                                                                               | COMBO   | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width`           | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 6240 (step 2)       |
| `height`          | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 4992 (step 2)       |
| `max_images`      | 생성할 최대 이미지 수입니다. 1이면 정확히 하나의 이미지가 생성됩니다. 1보다 크면 모델은 1개에서 max\_images개 사이의 관련 이미지(예: 스토리 장면, 캐릭터 변형)를 생성합니다. 총 이미지 수(입력 + 생성)는 15개를 초과할 수 없습니다. 기본값: 1.               | INT     | 아니요 | 1 \~ 14                     |
| `fail_on_partial` | 활성화하면 요청된 이미지가 누락되거나 오류를 반환하는 경우 실행을 중단합니다. 기본값: false.                                                                                                              | BOOLEAN | 아니요 | true / false                |
| `seed`            | 생성에 사용할 시드입니다. 기본값: 42.                                                                                                                                              | INT     | 아니요 | 0 \~ 2147483647             |
| `watermark`       | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false.                                                                                                                    | BOOLEAN | 아니요 | true / false                |
| `thinking`        | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 특히 Seedream 5.0 Pro에서 생성 시간이 크게 늘어날 수 있습니다. 텍스트-이미지 생성에서만 비활성화할 수 있으며, 참조 이미지가 제공되는 경우에는 비활성화할 수 없습니다. 기본값: true. | BOOLEAN | 아니요 | true / false                |

### Seedream 4.5 입력 (seedream-4-5-251128)

| 매개변수              | 설명                                                                                                                                                                   | 데이터 타입  | 필수  | 범위                          |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | --------------------------- |
| `size_preset`     | 권장 크기를 선택합니다. 아래의 너비와 높이를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋.                                                                                               | COMBO   | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width`           | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 6240 (step 2)       |
| `height`          | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 4992 (step 2)       |
| `max_images`      | 생성할 최대 이미지 수입니다. 1이면 정확히 하나의 이미지가 생성됩니다. 1보다 크면 모델은 1개에서 max\_images개 사이의 관련 이미지(예: 스토리 장면, 캐릭터 변형)를 생성합니다. 총 이미지 수(입력 + 생성)는 15개를 초과할 수 없습니다. 기본값: 1.               | INT     | 아니요 | 1 \~ 10                     |
| `fail_on_partial` | 활성화하면 요청된 이미지가 누락되거나 오류를 반환하는 경우 실행을 중단합니다. 기본값: false.                                                                                                              | BOOLEAN | 아니요 | true / false                |
| `seed`            | 생성에 사용할 시드입니다. 기본값: 42.                                                                                                                                              | INT     | 아니요 | 0 \~ 2147483647             |
| `watermark`       | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false.                                                                                                                    | BOOLEAN | 아니요 | true / false                |
| `thinking`        | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 특히 Seedream 5.0 Pro에서 생성 시간이 크게 늘어날 수 있습니다. 텍스트-이미지 생성에서만 비활성화할 수 있으며, 참조 이미지가 제공되는 경우에는 비활성화할 수 없습니다. 기본값: true. | BOOLEAN | 아니요 | true / false                |

### Seedream 4.0 입력 (seedream-4-0-250828)

| 매개변수              | 설명                                                                                                                                                                   | 데이터 타입  | 필수  | 범위                          |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | --------------------------- |
| `size_preset`     | 권장 크기를 선택합니다. 아래의 너비와 높이를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋.                                                                                               | COMBO   | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width`           | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 6240 (step 2)       |
| `height`          | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048.                                                                                         | INT     | 아니요 | 1024 \~ 4992 (step 2)       |
| `max_images`      | 생성할 최대 이미지 수입니다. 1이면 정확히 하나의 이미지가 생성됩니다. 1보다 크면 모델은 1개에서 max\_images개 사이의 관련 이미지(예: 스토리 장면, 캐릭터 변형)를 생성합니다. 총 이미지 수(입력 + 생성)는 15개를 초과할 수 없습니다. 기본값: 1.               | INT     | 아니요 | 1 \~ 10                     |
| `fail_on_partial` | 활성화하면 요청된 이미지가 누락되거나 오류를 반환하는 경우 실행을 중단합니다. 기본값: false.                                                                                                              | BOOLEAN | 아니요 | true / false                |
| `seed`            | 생성에 사용할 시드입니다. 기본값: 42.                                                                                                                                              | INT     | 아니요 | 0 \~ 2147483647             |
| `watermark`       | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false.                                                                                                                    | BOOLEAN | 아니요 | true / false                |
| `thinking`        | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 특히 Seedream 5.0 Pro에서 생성 시간이 크게 늘어날 수 있습니다. 텍스트-이미지 생성에서만 비활성화할 수 있으며, 참조 이미지가 제공되는 경우에는 비활성화할 수 없습니다. 기본값: true. | BOOLEAN | 아니요 | true / false                |

### 참조 입력

| 매개변수     | 설명                                                                                                                                                                                       | 데이터 타입 | 필수  | 범위                                                                                      |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --- | --------------------------------------------------------------------------------------- |
| `images` | 확장 가능한 슬롯: 이미지-이미지 또는 다중 참조 생성을 위한 선택적 참조 이미지입니다. 1..N개의 이미지를 연결하세요(예: `image_1`, `image_2`, ...). 개수 제한은 모델별로 적용됩니다(아래 참고 사항 참조). 연결된 이미지에 이미지 배치가 포함된 경우, 해당 배치의 모든 이미지가 제한 개수에 포함됩니다. | IMAGE  | 아니요 | 0 \~ 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)<br />0 \~ 14 (Seedream 5.0 Lite) |

**참고:**

* `prompt`는 앞뒤 공백을 제거한 후 비어 있으면 안 됩니다.
* 최대 참조 이미지 수: Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0은 10개, Seedream 5.0 Lite는 14개입니다.
* 각 참조 이미지의 종횡비는 1:3에서 3:1 사이여야 합니다.
* `max_images`가 1보다 큰 경우(Seedream 5.0 Pro에서는 사용 불가), 참조 이미지와 생성 이미지의 총 개수는 15개를 초과할 수 없습니다.
* `thinking`은 텍스트-이미지 생성에서만 비활성화할 수 있습니다. 참조 이미지가 제공되면 `thinking`을 반드시 활성화해야 합니다.
* `width`와 `height`는 `size_preset`이 "Custom"으로 설정된 경우에만 사용됩니다.
* `prompt_optimization`은 Seedream 5.0 Pro에서만 사용할 수 있습니다.
* `max_images`와 `fail_on_partial`은 Seedream 5.0 Lite, Seedream 4.5, Seedream 4.0에서만 사용할 수 있습니다. Seedream 5.0 Pro는 항상 단일 이미지를 요청합니다.
* 해상도 요구 사항(너비 x 높이):
  * Seedream 5.0 Pro: 0.92MP(921,600픽셀)\~4.19MP(4,194,304픽셀) 사이.
  * Seedream 5.0 Lite 및 Seedream 4.5: 최소 3.68MP(3,686,400픽셀).
  * Seedream 4.0: 최소 0.92MP(921,600픽셀).
  * 모든 비 Pro 모델: 최대 16.78MP(16,777,216픽셀).

## 출력

| 출력 이름   | 설명                                                   | 데이터 타입 |
| ------- | ---------------------------------------------------- | ------ |
| `image` | 생성된 이미지 텐서입니다. 여러 이미지가 생성된 경우 단일 배치 IMAGE 텐서로 연결됩니다. | IMAGE  |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ko.md)

***

**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac`