Skip to main content

개요

FLUX는 독일에 기반을 둔 Black Forest Labs(BFL)의 대표 이미지 생성 모델 패밀리입니다. 최신 FLUX.2 세대는 1초 미만부터 4MP 플래그십 품질까지 5개 티어를 제공하며, 이미지 편집용 이전 세대 FLUX.1 Kontext와 함께 총 7개의 활성 모델이 있습니다. 레거시 FLUX.1 [pro] 모델도 계속 호출할 수 있습니다. APIYI 게이트웨이는 BFL의 비동기 폴링 API를 동기식 OpenAI Images API(/v1/images/generations and /v1/images/edits)로 감싸므로, 단 base_url 변경만으로 OpenAI SDK를 그대로 사용할 수 있습니다.
🎨 주요 하이라이트: FLUX.2 [max]는 실시간 웹 지식을 위한 그라운딩 검색을 독보적으로 지원합니다. 네이티브 4MP 출력(2048×2048) + 최대 8개의 다중 참조 이미지 + 32K-token 프롬프트 + 정밀한 16진 색상 제어 + 최고 수준의 타이포그래피를 제공합니다. 플래그십 품질, 다중 이미지 일관성, 브랜드 색상 충실도, 전문적인 레이아웃이 중요한 운영 환경에 이상적입니다.
모든 image API는 동기식입니다. 폴링할 task ID가 없으며, 클라이언트가 연결을 끊으면 요청은 여전히 과금되지만 결과는 사라집니다. 이 모델에는 충분히 넉넉한 timeout을 설정하십시오. Image API Essentials & Best Practices를 참조하십시오.

텍스트-투-이미지 API

/v1/images/generations, 5개 FLUX.2 모델 전반에서 텍스트 프롬프트로 이미지를 생성합니다.

이미지 편집 API

JSON input_image 필드(융합용 참조 최대 8개, /generations를 통해), 그리고 OpenAI 호환 multipart /edits 단일 이미지 경로를 제공합니다. FLUX.2 + FLUX.1 Kontext에서 사용할 수 있습니다.

과거 버전

FLUX.1 [pro] / [pro] 1.1 / [pro] 1.1 Ultra / [dev]의 사양, 마이그레이션 노트, 가격입니다.

APIYI의 FLUX를 사용하는 이유는?

BFL 공식 채널의 드롭인 대체재로, 프로덕션에서 안정성, 비용, 통합 경험 측면에 최적화되어 있습니다:

OpenAI 호환 래퍼 · 코드 없는 마이그레이션

BFL 기본 방식은 비동기 폴링을 사용하지만, APIYI는 이를 동기식 OpenAI Images API로 래핑합니다. OpenAI SDK의 base_url를 여기에 연결하면 됩니다 — 직접 polling_url 루프를 작성할 필요가 없습니다.

동시 실행 수 제한 없음 · 활성 작업 24개 초과

BFL은 각 계정을 활성 작업 24개로 제한합니다(flux-kontext-max은 6개뿐입니다). APIYI는 요청을 게이트웨이에서 풀링하므로, 기업 사용자는 계정별 상한 없이 선형적으로 확장할 수 있습니다.

동일한 가격 또는 최대 17% 할인

FLUX.2 [pro/max/flex]는 1MP에서 공식 가격과 동일하며, klein 4B/9B는 약 28% 저렴하고, FLUX.1 [pro] 1.1 Ultra는 17% 절감되며, 충전 보너스를 함께 적용하면 최대 15% 추가 할인을 받을 수 있습니다.

전 세계 무마찰 접근

해외 서버나 프록시가 필요하지 않습니다. 중국 본토 데이터 센터, 주거용 네트워크, 글로벌 노드 모두 안정적인 지연 시간으로 api.apiyi.com에 직접 접근할 수 있습니다.

완전한 모델 생태계

같은 게이트웨이에서 gpt-image-2, Seedream, Nano Banana 및 기타 모델과 함께 사용할 수 있으며 — 시나리오별로 조합할 수 있습니다.

전문 서비스 · 엔터프라이즈 지원

저희 팀은 이미지 생성 배포에 대한 깊은 경험을 보유하고 있습니다 — 모델 선택, 튜닝, PoC부터 프로덕션까지의 통합 지원을 제공합니다.

주요 기능

전 속도 스펙트럼

klein 4B/9B 1초 미만은 소비자용 GPU에서, pro < 10s, max < 15s로, flex는 더 높은 정밀도를 위해 더 느립니다. 실시간부터 플래그십까지 하나의 패밀리입니다.

네이티브 4MP 출력

최대 2048×2048(~4MP)까지 지원하여 FLUX.1의 1.6MP 한도보다 2.5배 큽니다. 모든 종횡비를 지원하며(치수는 16의 배수여야 합니다), 최소 64×64입니다.

다중 참조 퓨전

JSON 필드 input_image ~ input_image_8에는 여러 참조(URL 또는 base64 data URL)가 포함됩니다: FLUX.2 [pro/max/flex]는 최대 8개, [klein]은 최대 4개까지 지원합니다. prompt에서는 “image 1 / image 2”처럼 참조합니다.

그라운딩 검색

FLUX.2 [max] 전용입니다: prompt가 실시간 웹 검색을 트리거하여 “어제 경기 점수”, “실시간 날씨”, “역사적 사건 재현” 등을 렌더링할 수 있습니다.

정확한 Hex 색상 제어

prompt에 #02eb3c / #ff0088와 같은 hex 코드를 직접 입력합니다. 모델이 정확한 색상을 렌더링하므로 브랜드에 민감한 작업에서 후처리가 필요 없습니다.

32K-Token 장문 prompt

구조화된 JSON 설명(주제 / 배경 / 조명 / 스타일)을 포함해 최대 32K tokens를 지원합니다. 프로덕션 자동화에 이상적입니다.

타이포그래피 최적화

FLUX.2 [flex]는 타이포그래피에 맞춰 특별히 설계되었습니다. 포스터 헤더, UI 목업, 인포그래픽 — 작은 텍스트 충실도는 업계를 선도합니다. max / pro도 잘 작동합니다.

OpenAI SDK 바로 적용

base_urlhttps://api.apiyi.com/v1로 설정하고 client.images.generate(model="flux-2-pro", ...)를 바로 호출하면 됩니다 — 코드 변경 없이.

가격

이미지당 가격 — APIYI 가격 열을 참조하십시오. BFL의 공식 가격은 MP(메가픽셀) 기준이며, 1MP 이내에는 기본 요금이 있고 추가 MP마다 증분 비용이 붙습니다. APIYI의 이미지당 고정 요금은 더 예측 가능합니다.

FLUX.2 시리즈 (최신 세대)

FLUX.1 Kontext 시리즈 (이미지 편집 전문)

FLUX.1 [pro] 레거시 (역사적 버전, 여전히 호출 가능)

상세 사양과 마이그레이션 안내는 과거 버전 페이지를 참조하십시오.
가격 참고사항:
  • APIYI는 이미지당 고정 요금을 사용합니다 — 출력 MP와 관계없이 비용이 동일합니다
  • 공식 가격은 MP 구간별입니다: 첫 MP에는 기본 요금이 적용되고 추가 MP마다 증분 비용이 붙습니다
  • 편집 요청은 텍스트-투-이미지와 동일한 비용입니다(OpenAI gpt-image-2에서는 편집이 Vision tokens으로 과금되는 것과 다릅니다)
  • klein 4B / klein 9B 오픈 웨이트는 Hugging Face에서 셀프 호스팅용으로 제공됩니다(Apache 2.0 / FLUX NCL)
  • 실패한 요청(4xx / moderation 차단)은 과금되지 않습니다

기술 사양

API 엔드포인트

다중 참조 융합에는 /generations(JSON input_image_N)을 사용합니다. /edits 엔드포인트는 단일 image 파일만 허용하며, 기존 OpenAI SDK 편집 코드를 마이그레이션할 때 가장 적합합니다.
도메인 옵션: api.apiyi.com이 주 도메인입니다. b.apiyi.com / vip.apiyi.com 같은 대체 게이트웨이 도메인도 동일하게 동작합니다.

크기(너비 / 높이) 상세

일반적인 치수

사용자 지정 크기 제약

FLUX.2는 다음 조건을 모두 만족하는 한 임의의 치수를 허용합니다:
  1. 너비 / 높이는 16의 배수여야 합니다
  2. 최소 64×64
  3. 최대 ~4MP (예: 2048×2048 / 1920×2048 / 2048×1920)
  4. 속도와 비용의 균형을 위해 총합은 2MP 이하를 권장합니다
유효한 예시: 1280x720, 1920x1080, 2048x1024, 1456x1920 유효하지 않은 예시: 1000x1000 (16의 배수가 아님), 3840x2160 (4MP 초과), 32x32 (64×64 미만)
API: width/height vs OpenAI-compatible size: BFL은 기본적으로 정수 width / height를 사용합니다. APIYI도 OpenAI 스타일의 size: "1024x1024" 문자열을 허용합니다. 둘은 동일하므로 아무거나 선택하면 됩니다.

모범 사례

1

시나리오별로 모델 선택

플래그십 최종 + 실시간 지식 필요 → flux-2-max. 프로덕션 배치 → flux-2-pro. 타이포그래피 포스터 / 인포그래픽 → flux-2-flex. 고처리량 실시간 → flux-2-klein-9b. 이미지 편집 → flux-kontext-max 또는 flux-kontext-pro.
2

기본은 ≤ 2MP

속도와 비용의 최적 구간은 1MP–2MP입니다. 4MP는 정말 필요할 때만 사용합니다(인쇄, 4K 화면). 고해상도에서 klein은 호출당 비용을 눈에 띄게 높입니다.
3

prompt에서 인덱스로 참조 이미지 지정

input_image / input_image_2 / input_image_3의 번호는 prompt의 “image 1 / image 2 / image 3” 인덱스와 정확히 일치합니다. “image 1의 인물, image 2의 장면, image 3의 색상 팔레트”라고 말하는 편이 모델이 추측하게 두는 것보다 훨씬 더 신뢰할 수 있습니다.
4

결과 URL을 즉시 다운로드

data[0].url10분 동안만 유효합니다, delivery-eu.bfl.ai / delivery-us.bfl.ai에 호스팅되며 CORS가 비활성화되어 있습니다. 프로덕션에서는 서버 측에서 다운로드하여 자체 CDN에 저장해야 합니다.
5

타이포그래피는 flex 또는 max로 고정

간판 텍스트, 포스터, UI 스크린샷에는 flux-2-flex(타이포그래피 특화) 또는 flux-2-max(전체 품질 최고)을 우선 사용합니다. 다른 모델은 작은 텍스트가 여전히 흐려질 수 있습니다.
6

그라운딩 검색에는 max 사용

실시간 지식(“오늘의 날씨”, “어젯밤 경기”)은 flux-2-max에서만 지원됩니다. 다른 모델은 학습 데이터에 의존하므로 실시간 정보를 가져올 수 없습니다.
7

클라이언트 타임아웃 60–120s

APIYI는 폴링을 내부적으로 처리하며 pro / max는 < 15초 내에 반환되지만, 큐잉과 네트워크 지터를 고려해 클라이언트 타임아웃은 60–120초로 설정합니다. flex는 최대 180초까지 가능합니다.
8

재현성을 위해 seed 고정

동일한 seed + 동일한 다른 파라미터 = 일관된 결과로, A/B 테스트와 클라이언트 검토에 유용합니다. klein은 prompt_upsampling를 지원하지 않으며, pro/max/flex는 기본적으로 꺼져 있으므로 필요할 때 사용 설정합니다.

오류 코드 및 재시도

권장 클라이언트 설정:
  • 요청 타임아웃 60–120s(최대 180s까지 유연하게)
  • 5xx 및 429에 대한 지수 백오프(재시도 2회 권장)
  • data[0].url를 받으면 즉시 비동기로 다운로드하십시오 — 사용자의 클릭을 기다리지 마십시오
  • 지원을 위해 x-request-id 응답 헤더를 기록하십시오

자주 묻는 질문

BFL은 결과를 delivery-eu.bfl.ai / delivery-us.bfl.ai에 10분 동안 유효한 서명된 URL로 호스팅하며, CORS는 비활성화되어 있습니다. 프로덕션 서비스는 서버 측에서 자체 OSS / CDN으로 다운로드해야 합니다. 원본 URL을 브라우저에 전달하지 말고, 사용자가 나중에 접근할 수 있다고 기대해서도 안 됩니다.APIYI는 동일한 URL 메커니즘을 그대로 상속합니다. 동작은 공식 채널과 동일합니다.
APIYI 게이트웨이가 폴링을 대신 처리합니다. 표준 OpenAI Images API 요청을 보내면, 게이트웨이가 내부적으로 BFL에 POST한 뒤 polling_urlReady까지 폴링하고, 최종 result.sample URL을 data[0].url로 감싸서 반환합니다. 클라이언트 입장에서는 단일 요청-응답이며, OpenAI / GPT-Image / Nano Banana와 동일합니다.
  • FLUX.2 [pro/max/flex]: 최대 8장
  • FLUX.2 [klein]: 최대 4장
  • FLUX.1 Kontext [pro/max]: 단일 참조만 지원함(다중 이미지는 클라이언트 측 스티칭 필요)
prompt에서 인덱스(“image 1 / image 2 / image 3”)로 참조하면 됩니다. 예: “image 1의 사람을 image 2의 장면에 배치하고, image 3의 색상 팔레트를 적용하세요”. 자연어 참조도 동작하며, 모델은 입력 이미지를 잘 이해합니다.
prompt_upsampling=true는 prompt를 자동으로 확장하고 다듬어 줍니다(특히 짧은 prompt에 유용합니다). 하지만 원래 의도를 변경합니다. 브랜드 작업에는 끄고, 자유로운 탐색에는 켜 두십시오.제한 사항: FLUX.2 [klein]은 이를 지원하지 않습니다(전달해도 조용히 무시됩니다).
flux-2-max만 이를 지원합니다. 별도의 파라미터는 필요하지 않습니다. prompt에 실시간 정보가 필요하면, 모델이 생성 전에 자동으로 웹을 검색합니다. 예:
“2025년 12월 15일 NYC를 강타한 눈보라에 대한 뉴스 사진을 생성하세요”
“어제 경기 스코어”, “실시간 날씨”, “역사적 사건 재현”, “최신 트렌드”에 적합합니다. 시간 민감한 내용이 없는 prompt는 검색을 트리거하지 않으며, 일반 생성으로 과금됩니다.
명시적인 “color” 또는 “hex” 마커와 함께 hex 코드를 prompt에 직접 작성하십시오:
또는 여러 색상을 쓰는 브랜드 작업의 경우:
업계 최고 수준의 정밀도를 제공합니다. 사후 색상 보정이 필요하지 않습니다.
FLUX.2는 JSON 형식의 prompts를 지원합니다:
JSON 문자열을 prompt 필드로 전달하십시오. 프로덕션 자동화와 템플릿 기반 배치 생성에 이상적입니다.
두 가지 옵션이 있습니다:
  • 옵션 A(권장): JSON + input_image(~ input_image_8)를 /v1/images/generations에 전달 — 모든 FLUX 모델에서 동작하며 다중 참조 융합을 지원합니다
  • 옵션 B: multipart/form-data/v1/images/edits에 전달 — 파일 필드 이름은 image이어야 하며(단일 이미지), OpenAI SDK의 client.images.edit()와 직접 호환되고, Kontext 시리즈에서 검증되었습니다
매개변수와 예시는 이미지 편집 API를 참조하십시오.참고: FLUX.1 Kontext는 기본적으로 단일 참조만 지원하며, FLUX.2는 최대 8개 참조를 지원합니다(옵션 A 사용 시).
네, 코드 변경이 전혀 필요 없습니다. base_urlhttps://api.apiyi.com/v1로 설정하십시오:
Node.js openai 패키지도 동일합니다. 모든 FLUX 모델은 data[0].url를 포함한 OpenAI Images API 응답 형식을 따릅니다.
지원하지 않습니다. 클라이언트가 연결을 끊어도 서버는 생성 작업을 계속 완료하며, 정상적으로 과금됩니다. 클라이언트 측 타임아웃을 설정하고 “연결 끊김 = 과금 없음”에 의존하지 마십시오.
BFL은 각 계정에 대해 활성 작업 24개로 제한하며, flux-kontext-max는 별도로 6개로 제한됩니다.APIYI는 게이트웨이에서 풀링하므로, 엔터프라이즈 동시 실행 수는 계정별 상한에 묶이지 않습니다. 명시적인 SLA / RPM 약정이 필요하면, 전용 쿼터를 위해 저희 팀에 문의하십시오.
BFL은 기본적으로 webhook_url + webhook_secret를 지원하지만, APIYI의 OpenAI 호환 래퍼는 동기적으로 대기하며 webhook 필드를 그대로 전달하지 않습니다. 폴링은 필요하지 않으며, 요청-응답은 한 번에 끝납니다. 비즈니스상 정말로 webhooks가 필요하다면, 네이티브 비동기 채널을 활성화할 수 있도록 문의하십시오.
아니요. 400(파라미터 오류), 403(moderation 차단), 429(요청 제한됨)은 모두 오류를 반환하며 과금되지 않습니다. 실제로 생성 단계에 진입한 요청(200 + data[0].url)만 과금됩니다.

관련 문서

FLUX는 BFL의 퍼스트파티 모델 패밀리로, 색상 코드 정밀도, 타이포그래피 충실도, 긴 prompt 이해에서 업계를 선도합니다. OpenAI 생태계 호환성을 우선한다면 GPT-Image-2를 보십시오. 중국어 시나리오라면 Seedream을 보십시오.