> ## Documentation Index > Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # QwenImageEditApi - ComfyUI Built-in Node Documentation > 이 노드는 Qwen-Image 3.0 모델을 사용하여 텍스트 프롬프트의 안내에 따라 최대 3개의 참조 이미지를 편집하거나 결합합니다. 모델을 선택하고, 프롬프트와 참조 이미지를 제공하면 노드가 하나 이상의 생성된 이미지를 반환합니다. 이 노드는 Qwen-Image 3.0 모델을 사용하여 텍스트 프롬프트의 안내에 따라 최대 3개의 참조 이미지를 편집하거나 결합합니다. 모델을 선택하고, 프롬프트와 참조 이미지를 제공하면 노드가 하나 이상의 생성된 이미지를 반환합니다. ## 입력 ### 공통 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | --------------- | ----------------------------------------------------------------------------------------------------------------- | -------------- | --- | ------------------------------------------ | | `model` | 사용할 모델입니다. 이 선택에는 텍스트 프롬프트, 최대 3개의 참조 이미지 입력, 선택적 부정 프롬프트도 포함됩니다. | DYNAMIC\_COMBO | 예 | "qwen-image-3.0-pro"
"qwen-image-3.0" | | `size` | 출력 해상도입니다. "match input"은 첫 번째 참조 이미지의 크기를 재사용하고, "auto"는 모델이 동일한 종횡비의 크기를 선택하게 하며, "custom"은 명시적인 너비와 높이를 설정합니다. | DYNAMIC\_COMBO | 예 | "match input"
"auto"
"custom" | | `n` | 생성할 이미지 수이며, 배치로 반환됩니다. (기본값: 1) | INT | 아니요 | 1 \~ 6 | | `seed` | 생성에 사용할 시드입니다. (기본값: 42) | INT | 아니요 | 0 \~ 2147483647 | | `prompt_extend` | AI 지원으로 프롬프트를 향상할지 여부입니다. (기본값: True) | BOOLEAN | 아니요 | True
False | | `watermark` | 결과에 AI 생성 워터마크를 추가할지 여부입니다. (기본값: False) | BOOLEAN | 아니요 | True
False | ### qwen-image-3.0-pro 및 qwen-image-3.0 입력 두 모델은 동일한 하위 매개변수를 공유합니다. | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | ----------------- | -------------------------------------------------------------------- | ------ | --- | -- | | `prompt` | 편집 지침입니다. 영어와 중국어를 지원하며, 입력 이미지에 대한 @Image1 스타일 참조를 지원합니다. (기본값: "") | STRING | 예 | - | | `negative_prompt` | 피해야 할 내용을 설명하는 부정 프롬프트입니다. (기본값: "") | STRING | 아니요 | - | ### 참조 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -- | -------- | | `images` | 확장 가능한 슬롯: 참조 이미지를 1\~3개 연결합니다(`image_1`, `image_2`, `image_3`). 프롬프트에서 입력 순서대로 번호가 매겨진 @Image1, @Image2, @Image3로 참조합니다. 배치 입력은 이미지당 한 번으로 계산됩니다. | IMAGE | 예 | 1 \~ 3 | ### 사용자 지정 크기 입력 `size`가 "custom"으로 설정된 경우 표시됩니다. | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | -------- | ------------------------------------------------------------------------------------------ | ------ | ----------------------- | ---------------------- | | `width` | 출력 너비입니다. 총 픽셀 영역은 512x512에서 2560x2560 사이여야 하며, 해당 영역 내에서는 어떤 종횡비든 사용할 수 있습니다. (기본값: 1024) | INT | 예 (`size`가 "custom"일 때) | 256 \~ 2560, step 16 | | `height` | 출력 높이입니다. 총 픽셀 영역은 512x512에서 2560x2560 사이여야 하며, 해당 영역 내에서는 어떤 종횡비든 사용할 수 있습니다. (기본값: 1024) | INT | 예 (`size`가 "custom"일 때) | 256 \~ 2560, step 16 | ### 제약 조건 * 텍스트 프롬프트는 필수이며, 최소 한 글자 이상을 포함해야 합니다. * 최대 3개의 참조 이미지만 지원하며, 더 많이 제공되면 오류가 발생합니다(배치 입력은 이미지당 한 번으로 계산됩니다). * `size`가 "custom"으로 설정된 경우 명시적인 너비와 높이 값을 제공해야 하며, 다음 조건으로 검증됩니다: 총 픽셀 영역은 262,144(512x512)에서 6,553,600(2560x2560) 픽셀 사이여야 하고, 종횡비는 1:8에서 8:1 사이여야 합니다. * `size`가 "match input"으로 설정된 경우 첫 번째 참조 이미지의 크기가 사용되므로 참조 이미지가 최소 하나 필요합니다. 크기는 지원되는 영역과 종횡비 범위에 맞게 조정됩니다. * `size`가 "auto"로 설정된 경우 모델이 입력 종횡비를 유지하면서 출력 크기(1.9\~4.2메가픽셀)를 선택합니다. * 프롬프트 참조는 입력 순서대로 번호가 매겨진 @Image1, @Image2, @Image3를 사용합니다. 연결된 이미지 수보다 높은 인덱스를 참조하면 오류가 발생합니다. 태그는 단어 경계에서만 인식되므로 [user@image1.com](mailto:user@image1.com)과 같은 주소는 변경되지 않습니다. * 입력 참조 이미지는 API로 전송되기 전에 최대 2048x2048 픽셀로 축소됩니다. PNG 인코딩이 API 크기 제한을 초과하면 대신 JPEG 인코딩이 사용됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | ------- | ------------------------------------------------ | ------ | | `IMAGE` | 생성된 이미지 또는 이미지들을 배치로 반환합니다. 최대 `n`개의 이미지가 반환됩니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/QwenImageEditApi/ko.md) *** **Source fingerprint (SHA-256):** `efa8d2b1a039a7b91789c0332b751a5f90ab8dad755ef0e25124d7d1c44d9abb`