솔라피 시작하기

가이드

OpenAI 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

OpenAI 노드 가이드

OpenAI API를 사용하여 텍스트 생성, 채팅 완성, 이미지 생성 및 편집을 수행하는 노드입니다.

주요 기능

리소스별 작업

리소스	작업	설명
Chat	Complete	GPT 모델을 사용한 채팅 완성 (멀티턴 대화)
Text	Complete	텍스트 완성 생성
Text	Edit	기존 텍스트를 지시에 따라 편집
Text	Moderate	텍스트가 OpenAI 콘텐츠 정책을 위반하는지 분류
Image	Create	텍스트 프롬프트로 이미지 생성 (DALL-E)
Image	Edit	기존 이미지를 프롬프트로 편집

설정 항목

공통 설정

항목	타입	기본값	설명
Resource	선택	`text`	사용할 리소스 (Chat, Image, Text)
Retry Count	숫자	`3`	API 호출 실패 시 재시도 횟수 (0~10)
Request Timeout	숫자	`300`	API 응답 최대 대기 시간 (초, 30~600)
Retry Delay	숫자	`2`	재시도 간 기본 대기 시간 (초, 지수 백오프 적용)

Chat > Complete

항목	타입	기본값	설명
Model	선택	`gpt-3.5-turbo`	API에서 사용 가능한 GPT 모델 목록에서 선택
Prompt (Messages)	컬렉션	-	Role(System/User/Assistant)과 Content로 구성된 메시지 목록
Simplify	불리언	`true`	응답을 간소화하여 메시지만 반환

Chat / Text 공통 옵션

항목	타입	기본값	설명
Frequency Penalty	숫자	`0`	반복 억제 패널티 (-2.0~2.0)
Maximum Number of Tokens	숫자	`16`	생성할 최대 토큰 수
Number of Completions	숫자	`1`	생성할 완성 수
Presence Penalty	숫자	`0`	새로운 주제 유도 패널티 (-2.0~2.0)
Sampling Temperature	숫자	`1`	무작위성 제어 (0.0~1.0)
Top P	숫자	`1`	핵 샘플링 (0.0~1.0)
Echo Prompt	불리언	`false`	완성과 함께 프롬프트도 반환

Text > Edit

항목	타입	기본값	설명
Model	선택	`text-davinci-edit-001`	편집 모델 선택
Input	문자열	-	편집할 입력 텍스트
Instruction	문자열	-	편집 방법을 지시하는 텍스트

Text > Moderate

항목	타입	기본값	설명
Model	선택	`text-moderation-latest`	분류 모델 (stable 또는 latest)
Input	문자열	-	분류할 텍스트

Image > Create

항목	타입	기본값	설명
Prompt	문자열	-	생성할 이미지에 대한 텍스트 설명 (최대 1000자)
Model	선택	`dall-e-2`	이미지 생성 모델 (DALL-E 2 또는 3)
Response Format	선택	`binaryData`	반환 형식 (Binary File / Image URL)
Number of Images	숫자	`1`	생성할 이미지 수 (1~10)
Quality	선택	`standard`	이미지 품질 - DALL-E 3 전용 (Standard / HD)
Resolution	선택	`1024x1024`	이미지 해상도 (모델별 옵션 상이)
Style	선택	`vivid`	이미지 스타일 - DALL-E 3 전용 (Natural / Vivid)

Image > Edit

항목	타입	기본값	설명
Image	문자열	`data`	편집할 이미지의 바이너리 속성 이름 (PNG, 4MB 이하, 정사각형)
Prompt	문자열	-	편집할 내용을 설명하는 텍스트
Model	선택	`dall-e-2`	편집 모델 (현재 DALL-E 2만 지원)
Mask	문자열	-	마스크 이미지의 바이너리 속성 이름 (선택사항)

인증 정보

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

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

사용 예시

블로그 글 자동 생성

Manual Trigger 노드로 워크플로우를 시작합니다.
OpenAI 노드에서 Chat > Complete를 선택합니다.
System 메시지에 "블로그 작성자 역할"을 지정하고, User 메시지에 주제를 입력합니다.
생성된 텍스트를 후속 노드에서 활용합니다.

이미지 생성 파이프라인

텍스트 프롬프트를 준비합니다.
OpenAI 노드에서 Image > Create를 선택하고 DALL-E 3 모델을 사용합니다.
Response Format을 Binary File로 설정하여 바이너리 데이터로 받습니다.
AWS S3 노드를 사용하여 생성된 이미지를 저장합니다.

콘텐츠 모더레이션

사용자 입력 텍스트를 받습니다.
OpenAI 노드에서 Text > Moderate를 선택합니다.
If 노드를 사용하여 위반 여부에 따라 분기 처리합니다.

참고 사항

커스텀 API 엔드포인트를 인증 정보에서 설정할 수 있어, OpenAI 호환 API 서버에도 사용 가능합니다.
재시도 로직에 지수 백오프(exponential backoff)가 적용되어, 429(Rate Limit), 5xx(서버 에러) 등의 일시적 오류를 자동 복구합니다.
Simplify 옵션을 활성화하면 응답에서 핵심 데이터(메시지, 텍스트)만 추출하여 후속 노드에서 다루기 쉽습니다.
토큰 사용량 정보(_usage)가 간소화된 응답에도 포함됩니다.
DALL-E 3 모델은 DALL-E 2보다 높은 품질의 이미지를 생성하지만, 한 번에 1장만 생성 가능합니다.