> ## 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.

# Tencent HY4: ComfyUI 이미지에서 프롬프트 생성 및 이미지 분석

> ComfyUI에서 Tencent HY4를 실행하여 참조 이미지를 아트 프롬프트, 캡션 또는 차트 분석으로 바꾸고, 추론, 다중 이미지, 토큰 제어를 활용하세요.

**Tencent HY4**는 Tencent의 대규모 언어 모델로, ComfyUI에서 `Tencent HY` 파트너 노드를 통해 사용할 수 있습니다. 이 노드는 텍스트 프롬프트와 최대 20개의 이미지를 입력받아 텍스트를 반환합니다. 참조 이미지를 바탕으로 작성된 아트 프롬프트, 캡션, 차트 분석, 또는 요청하는 그 밖의 어떤 답변이든 가능합니다.

Hy4는 2026년 11월 4일에 출시되었습니다. 시각적 이해를 갖춘 최초의 Hy 세대이며, Tencent는 Hy4 preview에 비해 지시 따르기, 긴 문맥 이해, 장기 과제 에이전트 작업에서 개선되었다고 보고합니다. 이 노드는 Comfy API를 통해 모델을 호출하므로 모델 다운로드도, 로컬 GPU도 필요하지 않습니다.

여기에서 다루는 템플릿은 이미지에서 프롬프트를 생성하는 예제입니다. 사진을 읽고 이미지 모델에 붙여넣을 수 있는 쉼표로 구분된 프롬프트를 작성합니다.

## Tencent HY 노드의 강점

* **이미지 → 프롬프트**: 피사체, 구도, 카메라, 조명, 색상, 질감, 스타일을 아우르는 구조화된 프롬프트를 작성합니다
* **이미지 이해**: 사진, 스크린샷, 문서에 대한 캡션, 차트 및 다이어그램 분석, 세부 사항 확인
* **요청당 여러 이미지**: 한 번의 호출로 최대 20개의 이미지를 처리하며, 배치의 각 이미지는 한 번씩 집계됩니다
* **지시 제어**: `system_prompt`는 상시 역할을 담당하고, `prompt`는 이번 실행의 작업을 전달합니다
* **추론 토글**: `reasoning`은 모델이 답변하기 전에 사고하도록 하며, 사고가 필요한 작업에 사용합니다
* **긴 답변**: `max_tokens`는 최대 64000 토큰을 허용합니다

> [!TIP]
>
> 파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](https://docs.comfy.org/ko/tutorials/partner-nodes/overview.md) 섹션을 참조해 주세요.

> [!TIP]
>
> > [tab] 로컬 사용자
> >
> > ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.
> >
> > * [ComfyUI 다운로드](https://www.comfy.org/download)
> > * [업데이트 가이드](https://docs.comfy.org/ko/installation/update_comfyui.md)
> >
> > 이 가이드의 워크플로는 [워크플로 템플릿](https://docs.comfy.org/ko/interface/features/template.md)에서 확인할 수 있습니다.
> > 템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.
> >
> > 워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:
> >
> > 1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
> > 2. 일부 노드가 시작 시 가져오기에 실패함
>
> > [tab] 클라우드 사용자
> >
> > * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.
> >
> > 따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.

## Tencent HY4 이미지-프롬프트 워크플로

이 템플릿은 참조 사진을 불러와 Tencent HY에 표준 아트 프롬프트를 요청하고, 필요하면 프롬프트와 답변을 실행 결과와 함께 저장할 수 있습니다.

![Tencent HY4 이미지-프롬프트 워크플로 미리보기](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_tencent_hy4-1.webp)

> [card] [워크플로 다운로드](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_tencent_hy4.json)
>
> JSON 다운로드 또는 템플릿 라이브러리에서 "Tencent: Hy4" 검색

**입력 자료**

이 파일을 해당 `LoadImage` 노드에 업로드하세요:

> [card] [blue\_poppies\_field.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/blue_poppies_field.png)
>
> `LoadImage` 노드 · `blue_poppies_field.png`

### 워크플로 실행 단계

이 워크플로는 Tencent HY로 응답을 생성하고, 필요하면 그 대화 기록을 ComfyUI에 저장하는 방법을 보여 줍니다. 참조 이미지를 불러와 그래프를 실행한 뒤 `Preview Any`에서 답변을 확인하세요. 저장이 필요하면 `Save Text`를 유지해 `output/Hy4/`에 프롬프트와 답변을 기록하고, 필요 없으면 해당 노드를 건너뛰거나 제거하세요.

### 프롬프트 작성 팁

* 출력 형식을 명시하세요. 템플릿의 `Only output positive prompt, no extra explanations` 문구가 답변을 바로 붙여넣을 수 있는 형태로 유지해 줍니다
* 여러 이미지를 연결할 때는 순서대로 언급하세요 (`the first image`, `the second image`). 그래야 세부 내용이 올바른 이미지에 적용됩니다
* 반복되는 지시는 `system_prompt`에 넣고 `prompt`는 작업용으로 남겨 두세요. 예: `You write photography prompts for a stock library`
* `seed`는 노드의 재실행 여부만 결정합니다. 답변은 실행할 때마다 여전히 달라집니다

## 시작하기

ComfyUI를 업데이트하고 Template Library에서 `Tencent: Hy4`를 검색한 뒤, 이미지를 프롬프트로 변환하는 워크플로를 여세요.

Tencent HY4는 API 토큰 사용량을 기준으로 과금됩니다. Hy4 요금은 [가격 표](https://docs.comfy.org/ko/tutorials/partner-nodes/pricing.md)를 참조하세요.


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