Grok xAI 노드 가이드
xAI의 Grok API를 사용하여 채팅 완성 및 이미지 생성을 수행하는 노드입니다.
주요 기능
리소스별 작업
리소스 | 작업 | 설명 |
|---|---|---|
Chat | Complete | Grok 모델을 사용한 채팅 완성 (멀티턴 대화) |
Image | Generate | 텍스트 프롬프트로 이미지 생성 |
설정 항목
공통 설정
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Resource | 선택 |
| 사용할 리소스 (Chat / Image) |
Retry On Fail | 불리언 |
| 실패 시 재시도 활성화 |
Max Retries | 숫자 |
| 최대 재시도 횟수 (Retry On Fail 활성화 시) |
Retry Delay (Seconds) | 숫자 |
| 재시도 간 대기 시간 (Rate limit 에러 시 60초 이상 권장) |
Chat > Complete
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Model | 선택 |
| 사용할 Grok 모델 |
Prompt (Messages) | 컬렉션 | - | Role(System/User/Assistant)과 Content로 구성된 메시지 목록 |
Simplify | 불리언 |
| 응답을 간소화하여 반환 |
Chat 모델 목록
모델 | 설명 |
|---|---|
grok-4-beta | Grok 4 베타 모델 (최신) |
grok-4.1 | Grok 4.1 모델 |
grok-4-vision-preview | Grok 4 비전 프리뷰 (이미지 이해 지원) |
grok-4 | Grok 4 안정 버전 |
grok-beta | Grok 베타 |
Chat 옵션
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Frequency Penalty | 숫자 |
| 반복 억제 패널티 (-2.0~2.0) |
Maximum Number of Tokens | 숫자 |
| 생성할 최대 토큰 수 (최대 131,072) |
Presence Penalty | 숫자 |
| 새로운 주제 유도 패널티 (-2.0~2.0) |
Sampling Temperature | 숫자 |
| 무작위성 제어 (0.0~2.0) |
Top P | 숫자 |
| 핵 샘플링 (0.0~1.0) |
Stream | 불리언 |
| 응답 스트리밍 여부 |
Image > Generate
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Prompt | 문자열 | - | 생성할 이미지에 대한 텍스트 설명 (최대 1000자) |
Model | 선택 |
| 이미지 생성 모델 |
Number of Images | 숫자 |
| 생성할 이미지 수 (1~10) |
Simplify | 불리언 |
| 첫 번째 이미지만 간소화하여 반환 |
Image 모델 목록
모델 | 설명 |
|---|---|
grok-2-image-1212 | Grok 2 Image 최신 버전 |
grok-2-image | Grok 2 Image |
인증 정보
이 노드는 Grok xAI API 인증 정보가 필요합니다.
자세한 설정 방법은 Grok xAI API 인증 설정 가이드를 참고하세요.
사용 예시
AI 채팅 어시스턴트
Grok xAI 노드에서 Chat > Complete를 선택합니다.
System 메시지에 어시스턴트의 역할을 정의합니다.
User 메시지에 사용자 질문을 입력합니다.
grok-4모델로 고품질 응답을 생성합니다.
이미지가 포함된 대화
grok-4-vision-preview모델을 선택합니다.User 메시지에 이미지 URL과 질문을 포함합니다.
이미지에 대한 분석 결과를 텍스트로 받습니다.
텍스트 기반 이미지 생성
Resource를 Image로 선택합니다.
프롬프트에 원하는 이미지를 설명합니다.
생성된 이미지 URL을 후속 노드에서 활용합니다.
참고 사항
커스텀 API 엔드포인트를 인증 정보에서 설정할 수 있어, 기본
https://api.x.ai/v1외의 엔드포인트도 사용 가능합니다.Retry On Fail을 활성화하면 Rate limit(429) 에러, 서버 에러(5xx), 네트워크 에러 발생 시 자동 재시도합니다.Rate limit 에러의 경우 Retry Delay를 60초 이상으로 설정하는 것이 권장됩니다.
Simplify옵션이 활성화되면 Chat은 메시지와 토큰 사용량(_usage)만, Image는 URL과 수정된 프롬프트만 반환합니다.grok-4-vision-preview모델은 이미지 이해(vision) 기능을 지원합니다.