> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/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.0, 4.5, 5.0 모델을 최대 4K 해상도로 사용합니다. 이 노드는 프롬프트와 참조 이미지를 ByteDan

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 flash"<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` | 권장 크기를 선택합니다. 아래의 `width`와 `height`를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋입니다. | COMBO | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width` | 이미지의 사용자 지정 너비입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4514(2 단위) |
| `height` | 이미지의 사용자 지정 높이입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4514(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 Flash 입력 (seedream 5.0 flash)

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `size_preset` | 권장 크기를 선택합니다. 아래의 `width`와 `height`를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋입니다. | COMBO | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width` | 이미지의 사용자 지정 너비입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4514(2 단위) |
| `height` | 이미지의 사용자 지정 높이입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4514(2 단위) |
| `seed` | 생성에 사용할 시드입니다. 기본값: 42. | INT | 아니요 | 0\~2147483647 |
| `watermark` | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false. | BOOLEAN | 아니요 | true / false |

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

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `size_preset` | 권장 크기를 선택합니다. 아래의 `width`와 `height`를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋입니다. | COMBO | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width` | 이미지의 사용자 지정 너비입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~6240(2 단위) |
| `height` | 이미지의 사용자 지정 높이입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4992(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` | 권장 크기를 선택합니다. 아래의 `width`와 `height`를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋입니다. | COMBO | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width` | 이미지의 사용자 지정 너비입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~6240(2 단위) |
| `height` | 이미지의 사용자 지정 높이입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4992(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` | 권장 크기를 선택합니다. 아래의 `width`와 `height`를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋입니다. | COMBO | 아니요 | 모델별 권장 크기 프리셋<br />"Custom" |
| `width` | 이미지의 사용자 지정 너비입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~6240(2 단위) |
| `height` | 이미지의 사용자 지정 높이입니다. `size_preset`이 `Custom`으로 설정된 경우에만 값이 적용됩니다. 기본값: 2048. | INT | 아니요 | 1024\~4992(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 5.0 Flash, Seedream 4.5, Seedream 4.0)<br />0~~14(Seedream 5.0 Lite) |

**참고:**

* `prompt`는 공백을 제거한 후 비어 있으면 안 됩니다.
* 최대 참조 이미지 수: Seedream 5.0 Pro, Seedream 5.0 Flash, Seedream 4.5, Seedream 4.0은 10개, Seedream 5.0 Lite는 14개입니다.
* 각 참조 이미지의 가로세로 비율은 1:16에서 16:1 사이여야 합니다.
* `max_images`가 1보다 큰 경우(Seedream 5.0 Pro 또는 Seedream 5.0 Flash에서는 사용할 수 없음), 참조 이미지 수와 생성된 이미지 수의 합은 15를 초과할 수 없습니다.
* `thinking`은 텍스트 투 이미지 생성에서만 비활성화할 수 있습니다. 참조 이미지가 제공되면 `thinking`은 활성화되어야 합니다. Seedream 5.0 Flash에는 `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와 Seedream 5.0 Flash는 항상 단일 이미지를 요청합니다.
* 해상도 요구 사항(너비 x 높이):
  * Seedream 5.0 Pro 및 Seedream 5.0 Flash: 0.92MP(921,600픽셀)에서 4.62MP(4,624,220픽셀) 사이입니다.
  * Seedream 5.0 Lite 및 Seedream 4.5: 최소 3.68MP(3,686,400픽셀)입니다.
  * Seedream 4.0: 최소 0.92MP(921,600픽셀)입니다.
  * Seedream 5.0 Lite, Seedream 4.5, Seedream 4.0: 최대 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):** `1c1f40b202ccbb3e0f73cd072170e1c16b833e007f26e63505b54c42b004a8a6`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.