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

# Gemini 4 Hydrogen: ComfyUI에서 이미지를 프롬프트로 변환

> ComfyUI의 Gemini 4 Hydrogen으로 참조 이미지를 읽고, Google Gemini 파트너 노드를 통해 아트 디렉션 프롬프트, 상세 캡션, 구조화된 시각 분석을 작성합니다.

Gemini 4 Hydrogen은 `Google Gemini` 파트너 노드에서 사용할 수 있는 Gemini 4 텍스트 모델 중 하나입니다. 참조 이미지와 텍스트 지시문을 첨부하면 모델이 요청한 텍스트를 작성합니다. 아트 디렉션 프롬프트, 상세 캡션, 또는 이미지 내용에 대한 구조화된 분석 등이 여기에 해당합니다. 결과는 일반 텍스트로 반환되므로, 채팅 창에서 끝나는 대신 같은 워크플로의 다른 노드로 전달될 수 있습니다.

## Gemini 4 Hydrogen이 잘하는 작업

* **프롬프트 역설계**: 이미지를 피사체, 구도, 카메라, 조명, 팔레트, 질감, 스타일을 아우르는 재사용 가능한 긍정 프롬프트로 바꿉니다
* **상세 캡션**: 정지 프레임에 대한 긴 설명 문구를 작성하며, 여러 문단에 걸쳐 설명이 일관되게 유지될 만큼의 추론 깊이를 갖춥니다
* **구조화된 시각 분석**: 레이아웃, 차트, 장면을 한 문단이 아니라 요소별로 분석해 달라고 요청합니다
* **멀티모달 컨텍스트**: 이미지 외에도 이 노드는 `Gemini Input Files`를 통해 오디오 클립, 비디오 클립, 파일을 입력받을 수 있으며, 총 최대 16개의 이미지까지 지원합니다
* **배치 주석**: `Save Text` 노드와 함께 워크플로에서 이미지 폴더를 실행하여 모든 결과가 파일로 저장되도록 합니다

> [!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 안정판 출시 후 업데이트됩니다.
> >
> > 따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.

## Gemini 4 Hydrogen 이미지로 프롬프트 만들기

공식 템플릿은 이미지 하나를 불러와, 표준 AI 아트 긍정 프롬프트를 요청하는 프롬프트와 함께 `Gemini 4 Hydrogen`으로 전송한 다음, 응답을 `Preview Any`에 표시하고 텍스트 파일로 저장합니다.

![이미지를 읽고 프롬프트를 작성하는 Gemini 4 Hydrogen 워크플로](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_google_gemini_4_hydrogen-1.webp)

> [card] [워크플로 다운로드](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_google_gemini_4_hydrogen.json)
>
> JSON을 다운로드하거나 템플릿 라이브러리에서 "Gemini 4 Hydrogen"을 검색하세요

**입력 자료**

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

1. `LoadImage` 노드에서 이미지를 불러오고 `Google Gemini` 노드의 `images` 입력에 연결합니다.
2. 다른 종류의 답변을 원한다면 `Text (User Prompt)` 노드의 텍스트를 수정하세요. 템플릿 프롬프트는 피사체, 구도, 카메라, 조명, 색상, 질감, 스타일을 요청하며, 긍정 프롬프트만 요청합니다.
3. 워크플로를 실행합니다. 응답은 `Preview Any`에 표시되고, `Save Text`는 이름이 `Gemini4_Hydrogen`으로 시작하는 `.txt` 파일을 `ComfyUI/output/Gemini/` 아래에 저장합니다. 파일 안에서 `USER PROMPT:` 뒤에는 사용자의 프롬프트가, `OUTPUT:` 뒤에는 모델의 응답이 이어집니다.

## 출력을 바꾸는 노드 설정

| 설정 | 기능 |
| - | - |
| `model` | **Gemini 4 Hydrogen**을 선택합니다. 같은 드롭다운에서 Gemini 4 Argon, Gemini 4 Carbon, Gemini 3.8 Flash 및 이전 Gemini 텍스트 모델도 선택할 수 있습니다 |
| `thinking_level` | 모델이 답변하기 전에 얼마나 추론할지 정합니다. Hydrogen은 `LOW`, `MEDIUM`, `HIGH`, `XHIGH`를 허용하며 기본값은 `HIGH`입니다. 레벨이 높을수록 thinking 토큰이 더 많이 소모되고 시간이 더 오래 걸립니다 |
| `max_output_tokens` | 생성되는 토큰의 상한이며 thinking도 포함합니다. 기본값은 65536입니다. 높은 thinking 레벨에서 응답이 비어 있거나 잘려서 돌아온다면 이 값을 올리세요 |
| `images`, `audio`, `video` | 선택적 멀티모달 컨텍스트입니다. 요청당 최대 16개 이미지, 오디오 클립 1개, 비디오 클립 1개까지 지원합니다 |
| `video_processing` | `static`은 고정된 비율로 프레임을 샘플링합니다. `agentic`은 모델이 타임라인을 탐색하며 필요한 프레임, 오디오 또는 트랜스크립트만 로드하도록 하여, 긴 비디오에서 입력 토큰을 훨씬 적게 사용합니다 |
| `system_prompt` | 모델에 대한 상시 지침으로, 하나의 프롬프트를 여러 이미지에 재사용할 때 유용합니다 |
| `files` | `Gemini Input Files` 노드에서 가져오는 선택적 파일 컨텍스트입니다. 먼저 파일을 `ComfyUI/input/`에 업로드하세요 |

> [!NOTE]
>
> Hydrogen에는 `temperature` 또는 `top_p` 위젯이 없습니다. 출력의 변화는 프롬프트, thinking 레벨, 시드에서 나오며, 결정론적 출력은 보장되지 않습니다.

## Gemini 4 모델 패밀리

`Google Gemini` 노드는 세 가지 Gemini 4 텍스트 모델을 제공합니다. 이 모델들은 하나의 입력 세트를 공유하며, 사고 수준과 반환할 수 있는 답변 길이에서 차이가 있습니다:

| 모델 | 사고 수준 | 기본값 | 최대 출력 토큰 |
| - | - | - | - |
| Gemini 4 Hydrogen | `LOW`, `MEDIUM`, `HIGH`, `XHIGH` | `HIGH` | 65536 |
| Gemini 4 Argon | `LOW`, `MEDIUM`, `HIGH` | `MEDIUM` | 32768 |
| Gemini 4 Carbon | `LOW`, `MEDIUM`, `HIGH` | `MEDIUM` | 32768 |

현재까지 템플릿이 제공되는 모델은 Hydrogen뿐입니다. Argon 또는 Carbon을 사용해 보려면 Hydrogen 워크플로를 복제하고 `model` 드롭다운을 전환하세요. 그래프의 나머지 부분은 동일하게 유지됩니다.

## 참고 사항

> [!NOTE]
>
> Gemini 4 Hydrogen 템플릿을 사용하려면 ComfyUI 0.46.0 이상이 필요합니다. 이전 빌드에서는 `Google Gemini` 노드에 Gemini 4 모델이 표시되지 않습니다. 이 템플릿의 Comfy Cloud 버전은 아직 없습니다.

* 이 워크플로는 사용자의 Comfy 계정에서 실행되며, 다른 파트너 노드와 동일한 크레딧으로 청구됩니다. 모델별 요금은 [파트너 노드 크레딧](https://docs.comfy.org/ko/tutorials/partner-nodes/pricing.md)을, 동시에 처리할 수 있는 요청 수는 [동시성 제한](https://docs.comfy.org/ko/tutorials/partner-nodes/concurrency-limits.md)을 참고하세요.
* `Batch Images` 예제를 포함한 원본 Gemini 채팅 워크플로는 [Google Gemini](https://docs.comfy.org/ko/tutorials/partner-nodes/google/gemini.md) 페이지에 그대로 있습니다.


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