FLUX.1 프로젝트 상세 소개

프로젝트 개요

FLUX.1은 Black Forest Labs에서 개발한 최첨단 텍스트-이미지 생성 AI 모델 시리즈입니다. 이 GitHub 저장소는 FLUX.1 모델의 공식 추론 코드를 제공하여 사용자가 이미지 생성 및 편집 기능을 실행할 수 있도록 합니다.

핵심 기능

모델 아키텍처

• 기반 구조: 정류 흐름 변환기(Rectified Flow Transformer) 블록 기반
• 파라미터 규모: 120억 파라미터로 확장
• 기술 혁신: 잠재적 적대적 확산 증류 기술을 사용하여 훈련

모델 버전

FLUX.1은 다양한 요구 사항을 충족하기 위해 여러 버전을 제공합니다.

1. FLUX.1 [schnell]

   • 빠른 버전, 1-4단계만으로 고품질 이미지 생성 가능
   • Apache-2.0 라이선스로 배포
   • 개인, 연구 및 상업적 용도 지원

2. FLUX.1 [dev]

   • 개발 버전, 더 높은 생성 품질 제공
   • 개발자의 연구 및 실험에 적합

3. FLUX.1 [pro]

   • 전문 버전, 최고 성능 제공
   • 4MP 이미지 생성 지원
   • 더 사실적인 효과를 위한 원본 모드 포함

기능 특징

• 텍스트-이미지 생성: 텍스트 설명을 기반으로 고품질 이미지 생성
• 이미지 편집: 부분 편집 및 생성적 수정 지원
• 텍스트 처리: 개선된 타이포그래피 생성 능력
• 통합 모델: 단일 모델로 다양한 생성 및 편집 작업 지원
• 캐릭터 일관성: 반복적인 워크플로우를 지원하고 캐릭터 일관성 유지

설치 및 사용

기본 설치

cd $HOME && git clone https://github.com/black-forest-labs/flux
cd $HOME/flux
python3.10 -m venv .venv
source .venv/bin/activate
pip install -e ".[all]"

TensorRT 지원 설치

TensorRT 지원이 필요한 경우 NVIDIA의 PyTorch 이미지를 사용해야 합니다.

cd $HOME && git clone https://github.com/black-forest-labs/flux
enroot import 'docker://$oauthtoken@nvcr.io#nvidia/pytorch:25.01-py3'
enroot create -n pti2501 nvidia+pytorch+25.01-py3.sqsh
enroot start --rw -m ${PWD}/flux:/workspace/flux -r pti2501
cd flux
pip install -e ".[tensorrt]" --extra-index-url https://pypi.nvidia.com

API 사용

Python 인터페이스

from flux.api import ImageRequest

# API 요청 생성
request = ImageRequest("A beautiful beach", name="flux.1.1-pro")
# 또는 API 키 사용: request = ImageRequest("A beautiful beach", name="flux.1.1-pro", api_key="your_key_here")

# 결과 URL 가져오기
request.url
# -> https:<...>/sample.jpg

# 이미지 바이트 데이터 가져오기
request.bytes
# -> b"..." 생성된 이미지의 바이트

# 로컬에 저장
request.save("outputs/api.jpg")

# PIL 이미지 객체 가져오기
request.image
# -> PIL 이미지

명령줄 인터페이스

# 생성된 이미지의 URL 가져오기
$ python -m flux.api --prompt="A beautiful beach" url
https:<...>/sample.jpg

# 결과 생성 및 저장
$ python -m flux.api --prompt="A beautiful beach" save outputs/api

# 이미지 직접 표시
$ python -m flux.api --prompt="A beautiful beach" image show

API 서비스

Black Forest Labs는 완전한 API 서비스를 제공합니다.

• API 문서: docs.bfl.ml
• API 등록: api.bfl.ml
• 사용 방법: 계정을 등록하고 API 키를 생성해야 합니다.

API 키 구성

export BFL_API_KEY=<your_key_here>

또는 코드에서 직접 제공:

api_key="your_key_here"

기술적 장점

1. 고품질 출력: 생성된 이미지 품질이 업계 최고 수준
2. 정확한 프롬프트 추종: 복잡한 텍스트 프롬프트를 정확하게 이해하고 실행 가능
3. 다양한 출력: 다양한 스타일과 테마의 이미지 생성 지원
4. 빠른 추론: schnell 버전은 극히 적은 단계 내에 생성 완료 가능
5. 유연한 배포: 로컬 배포 및 클라우드 API 호출 지원

관련 자료

• 공식 웹사이트: blackforestlabs.ai
• HuggingFace 모델:
  • FLUX.1-dev
  • FLUX.1-schnell
• 타사 플랫폼: Replicate, fal.ai 등 플랫폼에서도 FLUX 모델 서비스 제공

요약

FLUX.1은 현재 텍스트-이미지 생성 기술의 최고 수준을 대표하며, 고급 아키텍처 설계와 다중 버전 전략을 통해 연구자부터 상업 사용자까지 모든 유형의 사용자에게 강력하고 유연한 이미지 생성 솔루션을 제공합니다. 속도를 추구하는 빠른 프로토타입 개발이든 최고 품질이 필요한 전문적인 응용 프로그램이든 FLUX.1은 해당 솔루션을 제공할 수 있습니다.