Flux 2 Max API

Black Forest Labs의 Flux 2 제품군 최상위 모델(2025년 11월). 가장 높은 품질의 변형으로, 가장 정확한 프롬프트 준수, 가장 일관된 편집, 그리고 웹에서 실시간 정보를 가져오는 고유한 능력을 갖추고 있습니다.

Flux 2 Max을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

API 키 받기 Apiframe Studio에서 사용 Flux 2 Max API 문서 보기

model: "flux-2-max"

Flux 2 Max grounded generation: an isometric 3D weather card for Lisbon with a sun icon, date, and current temperature over a miniature city

Flux 2 Max의 특별한 점

제품군 최고의 품질

Flux 2 라인업에서 가장 높은 충실도와 포토리얼리즘을 제공하며, 최종 프로덕션 수준의 결과물을 위해 설계되었습니다.

가장 강력한 프롬프트 준수

복잡하고 상세한 긴 지시를 Pro 및 Flex 변형보다 정확하게 따르며, 최대 32k 토큰의 프롬프트를 지원합니다.

그라운디드 생성

대표 기능으로, 웹을 검색해 실시간 맥락을 가져올 수 있습니다. 참조 자료를 직접 준비하지 않아도 트렌드 제품, 시사, 날씨, 최신 스타일을 시각화할 수 있습니다.

동급 최고의 편집 일관성

색상·조명·얼굴·텍스트·오브젝트를 탁월한 충실도로 보존해, 편집과 변형이 새로 생성한 것이 아니라 자연스럽게 보입니다.

뛰어난 캐릭터·브랜드 일관성

최대 10장의 참조 이미지를 사용해 대량 출력 전반에서 정체성·제품·스타일을 안정적으로 유지합니다.

정밀한 리텍스처링과 색상 제어

형태와 지오메트리를 유지한 채 제품을 새로운 소재·색상·마감으로 바꿀 수 있고, HEX 코드로 정확한 브랜드 색상을 지정할 수 있습니다.

Flux 2 Max(으)로 제작

Apiframe의 Flux 2 Max API로 생성한 출력 예시입니다.

Flux 2 Max marketplace-ready product photo of a ceramic pour-over coffee set on a clean white surface in soft studio lighting — A polished photo of a ceramic pour-over coffee set on a clean white surface, soft studio lighting, sharp detail.

Flux 2 Max real-time weather card for Lisbon: an isometric 3D miniature of the city with current conditions, a weather icon, the date, and the temperature — Search the internet. A weather card for Lisbon today: an isometric 3D miniature of the city with current conditions, the title 'Lisbon', a weather icon, the date, and the temperature.

Flux 2 Max consistent-character campaign showing the same woman presenting on stage, reading at a desk, and walking outdoors with a stable face and outfit — Using these reference images of our character, show her presenting on stage, reading at a desk, and walking outdoors, keeping her face and outfit consistent.

Flux 2 Max product retexturing showing the same sofa in tan leather, dark green velvet, and light grey linen with identical shape and lighting — Show this sofa in tan leather, dark green velvet, and light grey linen, keeping the exact shape and lighting.

Flux 2 Max cinematic widescreen keyframe of a lone astronaut on a red desert planet at dusk with dramatic rim lighting and film grain — A cinematic key frame of a lone astronaut on a red desert planet at dusk, dramatic rim lighting, film grain, widescreen.

Flux 2 Max generating three new views of a single product (front, three-quarter, and top-down) with consistent materials and lighting — From this single product image, generate three new views: front, three-quarter, and top-down, with consistent materials and lighting.

개요

엔드포인트: POST /v2/images/generate
모델 ID: flux-2-max
파라미터 키: fluxParams
모달리티: 이미지
제공업체: Black Forest Labs
평균 완료 시간: ~20s

기능

화면 비율1:1, 3:4, 4:3, 9:16, 16:9

해상도0.5MP, 1MP, 2MP, 4MP

이미지 입력지원

평균 시간~20초

빠른 시작

API 키와 함께 POST /v2/images/generate 요청을 한 번 보내면 Flux 2 Max로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "flux-2-max",
        "fluxParams": {
            "resolution": "2MP",
            "image_prompt": "https://example.com/input.jpg",
            "image_prompt_strength": 0.5,
            "output_format": "jpg"
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "flux-2-max",
        "fluxParams": {
            "resolution": "2MP",
            "image_prompt": "https://example.com/input.jpg",
            "image_prompt_strength": 0.5,
            "output_format": "jpg"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "flux-2-max",
    "fluxParams": {
      "resolution": "2MP",
      "image_prompt": "https://example.com/input.jpg",
      "image_prompt_strength": 0.5,
      "output_format": "jpg"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

응답 및 작업 수명 주기

생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.

1. 제출 응답 (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 결과 폴링

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

입력 스키마

Flux 2 Max 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"flux-2-max"	"flux-2-max"	이 엔드포인트의 모델 식별자.
fluxParams.resolution	string	선택	"2MP"	"0.5MP", "1MP", "2MP", "4MP"	Resolution
fluxParams.image_prompt	string (URL)	선택	—	—	Reference image (URL)
fluxParams.image_prompt_strength	number	선택	0.5	min 0, max 1, step 0.05	How closely to follow the reference image (0–1).
fluxParams.output_format	string	선택	"jpg"	"jpg", "png", "webp"	Output format
fluxParams.output_quality	number	선택	90	min 0, max 100, step 1	Output quality
fluxParams.prompt_upsampling	boolean	선택	false	—	Let the model rewrite your prompt for better quality.
fluxParams.seed	number	선택	—	step 1	Reuse a number to reproduce the same result.

자주 묻는 질문

Flux 2 Max API에 대한 일반적인 질문입니다.

Flux 2 Pro 및 Flex와 어떻게 다른가요?

Max는 프리미엄 등급으로 최고 품질, 가장 강력한 프롬프트 준수, 가장 일관된 편집을 제공합니다. Pro는 프로덕션 주력 모델이고, Flex는 타이포그래피를 위한 파라미터 제어 옵션입니다.

그라운디드 생성이란 무엇인가요?

모델이 실시간 웹 맥락을 이미지에 가져올 수 있는 기능입니다. 참조 자료를 직접 제공하지 않아도 시사, 날씨, 트렌드 제품을 시각화할 수 있습니다.

비용은 얼마인가요?

메가픽셀당 약 $0.07로, Flux 2 제품군에서 가장 비싼 등급입니다.

참조 이미지는 몇 장까지 사용할 수 있나요?

한 번에 최대 10장까지 사용할 수 있어 강력한 캐릭터·제품·스타일 일관성을 구현합니다.

어떤 용도에 가장 적합한가요?

제품 마케팅과 이커머스, 브랜드·캐릭터 일관성, 리텍스처링, 인테리어 디자인, 비디오용 시네마틱 키프레임 등에 적합합니다.

어디에서 사용할 수 있나요?

Apiframe는 물론 BFL API와 주요 호스팅 파트너를 통해 사용할 수 있습니다.

아직 궁금한 점이 있으신가요?

고객 지원 문의 Discord 참여

Flux 2 Max API로 개발을 시작하세요

API 키를 받아 몇 분 만에 Flux 2 Max을(를) 통합하세요 — 사용한 만큼 지불.

무료 크레딧으로 시작

모든 모델을 위한 하나의 API

웹훅, SDK 및 멱등성

제공업체 계정 불필요

무료로 시작하기 문서 읽기

궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.