솔라피 시작하기

가이드

Gemini 텍스트 생성 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

Gemini 텍스트 생성 노드 가이드

Google Gemini API를 사용하여 텍스트 생성 및 멀티턴 채팅 대화를 수행하는 노드입니다.

주요 기능

리소스별 작업

리소스	작업	설명
텍스트	생성	단일 프롬프트로 텍스트를 생성
채팅	완성	멀티턴 대화(역할별 메시지)를 통한 텍스트 생성

설정 항목

텍스트 > 생성

항목	타입	기본값	설명
모델	선택	`gemini-2.5-flash`	사용할 Gemini 모델
프롬프트	문자열	-	AI에게 전달할 프롬프트 (필수)
시스템 지시사항	문자열	-	모델의 동작 방식을 안내하는 시스템 프롬프트

채팅 > 완성

항목	타입	기본값	설명
모델	선택	`gemini-2.5-flash`	사용할 Gemini 모델
메시지	컬렉션	-	역할(사용자/모델)과 내용으로 구성된 대화 메시지 목록 (최소 1개 필수)
시스템 지시사항	문자열	-	모델의 동작 방식을 안내하는 시스템 프롬프트

사용 가능한 모델

모델	설명
Gemini 3.1 Pro Preview	최신 추론 모델 (100만 토큰 컨텍스트) - 텍스트 전용
Gemini 3.0 Pro Preview	추론 모델 (100만 토큰 컨텍스트)
Gemini 2.5 Flash	빠르고 비용 효율적인 모델 (권장)
Gemini 2.5 Pro	고성능 모델
Gemini 1.5 Flash	이전 버전 Flash 모델 - 채팅 전용
Gemini 1.5 Pro	이전 버전 Pro 모델 - 채팅 전용

옵션 (공통)

항목	타입	기본값	설명
온도 (Temperature)	숫자	`1.0`	출력의 무작위성 제어 (0.0~2.0). 높을수록 창의적
최대 출력 토큰	숫자	`8192`	생성할 최대 토큰 수
Top P	숫자	`0.95`	핵 샘플링 (0.0~1.0)
Top K	숫자	`40`	상위 K개 토큰만 고려
추론 수준 (3.0/3.1 전용)	선택	`없음`	Gemini 3.0/3.1 모델의 추론 깊이 (높음/낮음/동적)
추론 예산 (2.5 전용)	숫자	`-1`	Gemini 2.5 모델의 thinking 예산 (0=비활성화, -1=기본값)
응답 MIME 타입	선택	`text/plain`	응답 형식 (텍스트 또는 JSON)
출력 간소화	불리언	`true`	생성된 텍스트만 출력하도록 간소화

인증 정보

이 노드는 Gemini API 인증 정보가 필요합니다.

자세한 설정 방법은 Gemini API 인증 설정 가이드를 참고하세요.

사용 예시

단일 텍스트 생성

Gemini 텍스트 생성 노드에서 리소스를 "텍스트"로 선택합니다.
프롬프트에 생성할 내용을 입력합니다.
시스템 지시사항에 "한국어로 답변해주세요" 등의 지시를 추가합니다.
옵션에서 응답 MIME 타입을 application/json으로 설정하면 구조화된 JSON 응답을 받을 수 있습니다.

대화형 AI 챗봇

리소스를 "채팅"으로 선택합니다.
메시지에 이전 대화 이력과 현재 사용자 메시지를 추가합니다.
시스템 지시사항에 챗봇의 역할과 규칙을 정의합니다.

구조화된 데이터 추출

시스템 지시사항에 "주어진 텍스트에서 정보를 추출하여 JSON 형식으로 응답하세요"를 입력합니다.
응답 MIME 타입을 application/json으로 설정합니다.
후속 노드에서 JSON 데이터를 파싱하여 활용합니다.

참고 사항

Gemini 2.5 모델은 thinkingBudget을 통해 추론 토큰 사용량을 제어할 수 있습니다. 단순 작업에는 0으로 설정하여 비용을 절약할 수 있습니다.
Gemini 3.0/3.1 모델은 thinkingLevel로 추론 깊이를 조절합니다. "동적" 설정은 작업 복잡도에 따라 자동 조정됩니다.
출력 간소화를 활성화하면 생성된 텍스트, 모델명, 종료 사유, 토큰 사용량(_usage)만 반환됩니다.
채팅 리소스에서는 최소 1개의 메시지가 필요합니다. 메시지가 없으면 에러가 발생합니다.
시스템 증명서를 통해 별도의 API 키 없이도 사용할 수 있습니다 (비용 별도 정산).