FLUX 3 Image API
Black Forest Labs의 FLUX 3 Image는 텍스트와 이미지를 입력받아 4K 해상도 이미지를 생성·편집하는 멀티모달 이미지 모델입니다.
FLUX 3 Image는 2026년 7월 23일 얼리 액세스로 공개된 FLUX 3 멀티모달 파운데이션 모델 패밀리의 이미지 생성·편집 모델입니다. 최대 10장의 참조 이미지를 활용한 다중 참조 생성과 픽셀 단위의 정밀 편집을 지원하며, 바운딩 박스로 요소 배치를 제어하고 편집 영역을 제한할 수 있습니다. 짧은 프롬프트 대신 장면 전체를 설명하는 캡션을 받아들이도록 설계되었고, 9B 프롬프트 업샘플러 모델과 결합해 요청을 상세한 장면 설명으로 확장할 수 있습니다.
디자인·광고 제작, 제품 시각화, 단일 참조 편집과 다중 참조 이미지 합성 같은 작업에 적합합니다. 네이티브 4K 해상도로 이미지를 만들 수 있으며, RTX 4070급 GPU에서도 실행됩니다. Diffusers 라이브러리와 첫날부터 통합되고, 미증류 기본 버전인 Klein Base는 파인튜닝·LoRA 학습·연구용으로, 증류된 Klein 버전은 생성·편집·셀프 호스팅용으로 제공됩니다.
BFL API 뒤에 있는 체크포인트는 증류 버전이며, 내부 평가에서 텍스트→이미지, 다중 참조 생성, 이미지 편집 부문 모두 1위를 기록했습니다. 다만 상세한 장면 설명을 만들기 위해서는 별도의 9B 프롬프트 업샘플러 모델이 필요하고, flux-kommunity-license가 상업적 사용에 조건을 부과합니다.
업데이트:
모델 ID
flux-3-image- 입력
- text / image
- 출력
- image
주요 특징
- 네이티브 4K 해상도 생성
- 픽셀 단위 정밀 편집
- 최대 10장 다중 참조 지원
- 바운딩 박스로 배치 제어
- RTX 4070급 GPU에서 실행
- Diffusers 첫날 통합
제공 업체
제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.
| 가동률 | ||
|---|---|---|
| 미공개 |
과거 통계는 실시간 상태 확인이 아닙니다. 데이터 누락이 장애를 뜻하지는 않습니다.
벤치마크
- #1
텍스트→이미지 순위(내부 평가)
FLUX 3 Image Klein이 비교 모델 중 1위를 기록했습니다.
- #1
다중 참조 생성 순위(내부 평가)
FLUX 3 Image Klein이 비교 모델 중 1위를 기록했습니다.
- #1
이미지 편집 순위(내부 평가)
FLUX 3 Image Klein이 비교 모델 중 1위를 기록했습니다.
- 91
FLUX.2 Klein 9B 대비 텍스트→이미지 향상
Elo 점수
- 70
FLUX.2 Klein 9B 대비 이미지 편집 향상
Elo 점수
- #1
Physics-IQ
세계에서 가장 강력한 월드 모델로 평가받았습니다.
점수는 모델 제공 업체가 공개한 값입니다.
Quick Start
이미지 작업을 제출하고 상태를 조회한 뒤 이미지를 저장합니다. curl과 Python 3 표준 라이브러리만 사용합니다.
POST https://openapi.felo.ai/api/v1/images/generations
1API key 설정
Felo API Platform 계정에서 key를 만들고 환경 변수로 설정하세요.
export FELO_API_KEY="YOUR_API_KEY"2첫 요청 보내기
선택 매개변수 값은 모델마다 달라 예제에서는 지정하지 않습니다. 추가 전에 Playground에서 확인하세요. 필드는 input 안이 아닌 model, prompt와 같은 수준에 둡니다.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "flux-3-image"
}'3작업 폴링
제출 후 task_id가 반환됩니다. queued 또는 running이면 3초마다 조회하고 succeeded, failed, interrupted이면 멈춥니다. 최대 30분 대기합니다. created.json을 보관하면 재제출 없이 같은 작업을 계속 조회할 수 있습니다.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4출력 다운로드
성공하면 task.json의 outputs를 저장합니다. HTTPS URL, URL 객체, b64_json을 지원합니다. 서명 URL은 즉시 다운로드하세요. 이미지 다운로드에는 API Key가 필요하지 않습니다.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
이미지 편집 시 예제 URL을 본인의 HTTPS 이미지 URL 또는 base64 이미지 data URL로 바꾸세요. 한 번 제출한 후 동일한 조회 및 저장 단계를 따릅니다.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "flux-3-image",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'지원 매개변수
- n
- resolution
- aspect_ratio
- input_references
전체 레퍼런스가 필요하신가요?
API 문서 →자주 묻는 질문
모델 소개: FLUX 3 Image?
FLUX 3 Image는 2026년 7월 23일 얼리 액세스로 공개된 FLUX 3 멀티모달 파운데이션 모델 패밀리의 이미지 생성·편집 모델입니다. 최대 10장의 참조 이미지를 활용한 다중 참조 생성과 픽셀 단위의 정밀 편집을 지원하며, 바운딩 박스로 요소 배치를 제어하고 편집 영역을 제한할 수 있습니다. 짧은 프롬프트 대신 장면 전체를 설명하는 캡션을 받아들이도록 설계되었고, 9B 프롬프트 업샘플러 모델과 결합해 요청을 상세한 장면 설명으로 확장할 수 있습니다. 디자인·광고 제작, 제품 시각화, 단일 참조 편집과 다중 참조 이미지 합성 같은 작업에 적합합니다. 네이티브 4K 해상도로 이미지를 만들 수 있으며, RTX 4070급 GPU에서도 실행됩니다. Diffusers 라이브러리와 첫날부터 통합되고, 미증류 기본 버전인 Klein Base는 파인튜닝·LoRA 학습·연구용으로, 증류된 Klein 버전은 생성·편집·셀프 호스팅용으로 제공됩니다. BFL API 뒤에 있는 체크포인트는 증류 버전이며, 내부 평가에서 텍스트→이미지, 다중 참조 생성, 이미지 편집 부문 모두 1위를 기록했습니다. 다만 상세한 장면 설명을 만들기 위해서는 별도의 9B 프롬프트 업샘플러 모델이 필요하고, flux-kommunity-license가 상업적 사용에 조건을 부과합니다.
사용 요금은 어떻게 계산되나요?
이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다.
FLUX 3 Image는 어떤 입력을 지원하나요?
텍스트 입력과 이미지 입력을 모두 지원하며, 이미지 출력을 생성합니다. 이미지와 프롬프트를 함께 입력하는 편집 작업도 가능합니다.
참조 이미지는 몇 장까지 사용할 수 있나요?
최대 10장의 참조 이미지를 활용한 다중 참조 생성이 가능합니다.
어떤 작업에 가장 적합한가요?
텍스트→이미지 생성, 단일 참조 이미지 편집, 다중 참조 이미지 합성, 디자인·광고 제작, 제품 시각화에 적합합니다.
FLUX 3 Image Klein의 두 가지 버전은 무엇이 다른가요?
미증류 기본 버전인 Klein Base는 파인튜닝·LoRA 학습·연구용이고, 증류된 Klein 버전은 생성·편집·셀프 호스팅용입니다. 기본 버전은 50스텝에 가이던스 3.5로, 증류 버전은 가이던스 없이 16스텝으로 실행됩니다.
프롬프트 업샘플러가 꼭 필요한가요?
네, 요청을 상세한 장면 설명으로 확장하려면 별도의 9B 프롬프트 업샘플러 모델이 필요합니다.
상업적 사용에 제약이 있나요?
flux-kommunity-license가 상업적 사용에 조건을 부과합니다.