ByteDanceSeedreamNodeV3 - ComfyUI Built-in Node Documentation

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" "seedream 5.0 lite" "seedream-4-5-251128" "seedream-4-0-250828”

Seedream 5.0 Pro 입력 (seedream 5.0 pro)

매개변수	설명	데이터 타입	필수	범위
`size_preset`	권장 크기를 선택합니다. 아래의 너비와 높이를 사용하려면 Custom을 선택하세요. 기본값: 이 모델의 첫 번째 권장 프리셋.	COMBO	아니요	모델별 권장 크기 프리셋 ”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" "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	아니요	모델별 권장 크기 프리셋 ”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	아니요	모델별 권장 크기 프리셋 ”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	아니요	모델별 권장 크기 프리셋 ”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) 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에서 편집

Source fingerprint (SHA-256): 68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac

​입력

​공통 입력

​Seedream 5.0 Pro 입력 (seedream 5.0 pro)

​Seedream 5.0 Lite 입력 (seedream 5.0 lite)

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

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

​참조 입력

​출력

입력