Flux 콘텍스트 노드 가이드
Flux Kontext API를 사용하여 고품질 AI 이미지를 생성하는 노드입니다. Pro와 Max 두 가지 모드를 지원합니다.
주요 기능
작업 | 설명 |
|---|---|
Generate Image (Pro) | Flux Kontext Pro를 사용하여 이미지 생성 |
Generate Image (Max) | Flux Kontext Max를 사용하여 더 높은 품질의 이미지 생성 |
설정 항목
기본 설정
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Operation | 선택 |
| 생성 모드 (Pro / Max) |
Prompt | 문자열 | - | 생성할 이미지에 대한 텍스트 설명 (필수) |
Aspect Ratio | 선택 |
| 이미지 가로세로 비율 |
Download Image | 불리언 |
| 이미지를 바이너리 데이터로 다운로드 |
Binary Property Name | 문자열 |
| 바이너리 데이터 저장 속성 이름 (Download Image 활성화 시) |
가로세로 비율 옵션
비율 | 설명 |
|---|---|
1:1 | 정사각형 |
16:9 | 가로 (와이드스크린) |
9:16 | 세로 (스마트폰) |
21:9 | 울트라 와이드 |
9:21 | 울트라 세로 |
4:3 | 스탠다드 |
3:4 | 세로 스탠다드 |
3:2 / 2:3 | 클래식 |
5:4 / 4:5 | 미디엄 |
7:5 / 5:7 | 와이드/톨 |
추가 옵션
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Reference Image | 문자열 | - | 참조할 이미지의 URL 또는 Base64 데이터 |
Reference Weight | 숫자 |
| 참조 이미지의 영향력 (0~1) |
Strength | 숫자 |
| 프롬프트의 영향력 강도 (0~10). 높을수록 창의적 |
Safety Tolerance | 숫자 |
| 콘텐츠 안전 필터 수준 (1=매우 엄격, 6=관대) |
Seed | 숫자 |
| 재현 가능한 결과를 위한 시드 값 (0=랜덤) |
Output Format | 선택 |
| 출력 이미지 형식 (JPEG / PNG) |
Number of Images | 숫자 |
| 생성할 이미지 개수 (1~4) |
Private Mode | 불리언 |
| 비공개 모드 (공개 갤러리에 비표시) |
Polling Interval (ms) | 숫자 |
| 결과 확인 폴링 간격 (밀리초, 100~5000) |
Max Polling Attempts | 숫자 |
| 최대 폴링 시도 횟수 (10~300). 초과 시 타임아웃 |
인증 정보
이 노드는 Flux Kontext API 인증 정보가 필요합니다.
자세한 설정 방법은 Flux Kontext API 인증 설정 가이드를 참고하세요.
사용 예시
기본 이미지 생성
Flux Kontext 노드를 추가합니다.
Operation을 "Generate Image (Pro)"로 선택합니다.
Prompt에 원하는 이미지를 설명합니다.
Aspect Ratio를 용도에 맞게 선택합니다 (예: YouTube 썸네일이면 16:9).
실행하면 이미지 URL이 반환됩니다.
참조 이미지를 활용한 생성
추가 옵션에서 Reference Image에 참조 이미지 URL을 입력합니다.
Reference Weight를 0.7로 설정하여 참조 이미지의 영향력을 높입니다.
Prompt에 원하는 변경 사항을 설명합니다.
참조 이미지의 스타일을 유지하면서 새로운 이미지가 생성됩니다.
이미지 다운로드 및 저장
Download Image를 활성화합니다.
Binary Property Name을 설정합니다 (기본:
data).생성된 이미지가 바이너리 데이터로 다운로드됩니다.
AWS S3 노드를 연결하여 이미지를 저장합니다.
고품질 이미지 (Max 모드)
Operation을 "Generate Image (Max)"로 선택합니다.
Strength를 높여 프롬프트의 영향력을 강화합니다.
Output Format을 PNG로 설정하여 무손실 이미지를 받습니다.
참고 사항
이미지 생성은 비동기적으로 처리됩니다. 요청 후 폴링을 통해 결과를 확인합니다.
기본 폴링 설정(500ms 간격, 120회)으로 최대 약 60초까지 대기합니다. 복잡한 이미지 생성 시 Max Polling Attempts를 늘려주세요.
Pro 모드는 빠르고 비용 효율적이며, Max 모드는 더 높은 품질의 이미지를 생성합니다.
Reference Image를 사용하면 기존 이미지의 스타일이나 구도를 유지하면서 새로운 이미지를 생성할 수 있습니다.
출력 JSON에 requestId, status, imageUrl, prompt, aspectRatio 등의 메타데이터가 포함됩니다.
Seed 값을 고정하면 동일한 프롬프트로 재현 가능한 결과를 얻을 수 있습니다.