> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Gemini 파트너 노드 ComfyUI 공식 예제

> 이 기사에서는 ComfyUI에서 Google Gemini 파트너 노드를 사용해 대화 기능을 완성하는 방법을 소개합니다.

Google Gemini는 Google에서 개발한 강력한 AI 모델로, 대화 및 텍스트 생성 기능을 지원합니다. 현재 ComfyUI는 Google Gemini API를 통합하여 ComfyUI에서 관련 노드를 직접 사용해 대화 기능을 수행할 수 있습니다.

## Google Gemini가 잘하는 것

* **대화 및 텍스트 생성**: ComfyUI 워크플로 내에서 직접 Google의 멀티모달 AI와 대화할 수 있습니다.
* **멀티모달 추론**: Gemini의 추론 기능으로 이미지를 해석합니다.
* **이미지-프롬프트 해석**: 공식 템플릿에는 이미지를 해당하는 그림 프롬프트로 변환하는 프롬프트가 포함되어 있습니다.
* **다중 이미지 입력**: `이미지 배치`를 사용하면 한 번의 실행으로 여러 이미지를 AI 해석에 보낼 수 있습니다.

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

<Tip>
  <Tabs>
    <Tab title="로컬 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로는 [워크플로 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

      워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

<h2 id="api_google_gemini">
  Google Gemini
</h2>

Gemini의 추론 기능으로 Google의 멀티모달 AI를 경험해 보세요.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_google_gemini-1.webp" alt="Google Gemini 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_google_gemini&utm_source=docs&utm_medium=referral&utm_campaign=gemini">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_google_gemini.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Google Gemini" 검색
  </Card>
</CardGroup>

**입력 자료**

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

<CardGroup cols={2}>
  <Card title="example.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/example.png">
    `LoadImage` 노드 2 · `example.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/example.png" alt="example.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

## 워크플로 실행을 단계별로 완료하기

<img src="https://mintcdn.com/dripart-docs-custom-nodes-sdk-v2-frontend/h7WtCFJIDzeC2ttN/images/tutorial/api_nodes/google/tripo_image_to_model_step_guide.jpg?fit=max&auto=format&n=h7WtCFJIDzeC2ttN&q=85&s=b3e4c08b56d2cc6b479dc614ccfbc3b5" alt="OpenAI 채팅 단계 가이드" width="3940" height="2092" data-path="images/tutorial/api_nodes/google/tripo_image_to_model_step_guide.jpg" />

<Note>
  해당 템플릿에는 역할 프롬프트를 분석하고 생성하기 위한 프롬프트가 내장되어 있으며, 이를 통해 이미지를 해당 드로잉 프롬프트로 해석합니다.
</Note>

이미지의 번호를 참조하여 기본 텍스트 기반 이미지 생성 워크플로 실행을 완료할 수 있습니다:

1. `Load Image` 노드에서 AI가 해석해야 할 이미지를 로드합니다.
2. (선택 사항) 필요한 경우 `Google Gemini`의 프롬프트를 수정하여 AI가 특정 작업을 실행하도록 할 수 있습니다.
3. `Run` 버튼을 클릭하거나 단축키 `Ctrl(cmd) + Enter`를 사용하여 대화를 실행합니다.
4. API가 결과를 반환할 때까지 기다린 후, `Preview Any` 노드에서 AI가 반환한 해당 콘텐츠를 확인할 수 있습니다.

## 추가 참고 사항

* 현재 파일 입력 노드 `Gemini Input Files`는 파일을 먼저 `ComfyUI/input/` 디렉토리에 업로드해야 합니다. 이 노드는 개선 중이며, 업데이트 이후 템플릿을 수정할 예정입니다.
* 워크플로는 입력에 `Batch Images`를 사용하는 예시를 제공합니다. AI 해석이 필요한 이미지가 여러 개인 경우, 단계 다이어그램을 참조하고 마우스 오른쪽 버튼을 클릭하여 해당 노드 모드를 `Always`로 설정하면 활성화할 수 있습니다.