Flux.2 Pro API

2026년 10월 19일 업데이트

Flux.2란?

Flux.2는 Black Forest Labs가 2025년 12월에 출시한 이미지 모델로, Flux 라인의 최신 진화형입니다. UnificAlly의 Flux 2 API는 같은 /v1/tasks 엔드포인트에서 세 가지 변형을 제공합니다. Flex(명시적인 디퓨전 컨트롤 포함), Pro(균형 잡힌 기본 모델), Max(5:4 화면 비율 추가)입니다. 세 변형 모두 같은 프롬프트-참조 핵심 구조를 공유합니다. 최대 10장의 선택적 참조 이미지 목록, 21:9부터 9:21까지 7가지 화면 비율, 0.6, 1, 2 또는 4메가픽셀 해상도입니다. 현재 프로덕션용 정지 이미지 분야에서 가장 강력한 오픈 모델 라인업입니다.

Flux.2의 주요 기능

이런 작업에 적합합니다

• 마케팅 정지 이미지

  정밀한 aspect_ratio와 resolution 설정으로 브랜드 크롭 규격에 맞춥니다.

• 콘셉트 아트

  룩을 확정하기 전에 steps와 guidance로 조정하는 Flex 모드.

• 참조 기반 디자인

  프롬프트와 함께 제품 또는 무드 보드 이미지를 image_urls로 전달합니다.

• 키 아트와 포스터

  시네마틱 21:9 레이아웃과 5:4 에디토리얼 표지를 위한 Max 화면 비율.

• UX와 슬라이드

  Flex 수준의 튜닝이 필요 없을 때 빠른 Pro 실행.

• 배치 파이프라인

  지연 시간과 예산에 따라 작업별로 Flex, Pro, Max를 선택합니다.

변형 모델

Flux.2는 같은 API에 세 가지 모델이 있으며, 각각 별도의 페이지가 있습니다. 프롬프트-참조 핵심 구조는 공유하지만, 각 모델이 제공하는 컨트롤 구성은 조금씩 다릅니다.

Pro

이 페이지의 모델입니다. 균형 잡힌 일상용 모델로, 7가지 화면 비율을 지원하고 수동 디퓨전 컨트롤이 없으며 호출당 속도가 더 빠릅니다. 마케팅 정지 이미지와 참조 기반 작업의 기본 선택지입니다.

Flex

명시적인 디퓨전 컨트롤을 제공합니다. steps와 guidance가 정식 파라미터입니다. 룩을 튜닝할 때(콘셉트 아트, 무드 반복) 설정값을 바꿔 가며 반복 가능한 동작을 원한다면 이 모델을 사용하세요.

Max

같은 핵심 구조를 최대 출력 품질에 맞춰 튜닝했습니다. 비용과 지연 시간보다 품질이 우선인 시네마틱 키 아트나 최종 렌더링 작업에 사용하세요.

활용 사례

Flex에서 steps와 guidance를 바꿔 가며 렌더링된 재질이 참조와 일치할 때까지 콘셉트 아트 룩을 튜닝한 뒤, seed를 고정하고 같은 프롬프트를 Pro로 옮겨 프로덕션 배치를 돌리세요. Pro에서 프롬프트 하나로 전체 비율 범위(21:9 배너, 16:9 랜딩, 1:1 피드, 9:16 릴스)에 걸친 마케팅 정지 이미지 세트를 만들 수 있습니다. 5:4 비율이 브리프인 에디토리얼 표지 작업에는 Max를 사용하세요. 어떤 변형에서든 최대 10장의 참조를 전달해 대량의 참조 기반 디자인(무드 보드, 제품 플랫레이)을 실행할 수 있습니다.

API 예시

/v1/tasks에 POST 요청을 보내면 어떤 언어에서든 Flux.2를 호출할 수 있습니다. 전체 파라미터 문서는 docs.unifically.com/models/image/flux/flux.2-pro에서 확인하세요.

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "black-forest-labs/flux.2-pro",
    "input": {
      "prompt": "A photorealistic portrait of a woman in golden hour light",
      "aspect_ratio": "9:16",
      "resolution": "2mp"
    }
  }'

요청이 정상적으로 접수되면 task_id가 반환됩니다. GET /v1/tasks/<task_id>를 폴링하거나 요청에 callback_url을 설정하면 완성된 결과를 받을 수 있습니다.