Black Forest Labs: FLUX.2 Max
FLUX.2 [max]는 까다로운 최종 에셋과 일관된 편집을 위한 Black Forest Labs의 이미지 모델입니다. 문서상 프로파일은 시각 참조, 상세 장면 제어와 최신 주제용 웹 그라운딩을 결합하며 최대 4메가픽셀을 출력합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
FLUX.2 [max]는 Black Forest Labs FLUX.2 이미지 생성·편집 제품군의 최고 품질 모델입니다. 제조사는 까다로운 최종 에셋, 복잡한 기획의 강한 준수와 편집 간 일관성을 위한 모델로 소개합니다. 글로 쓴 설명에서 이미지를 만들거나 제공 이미지를 시각 참조로 사용합니다. 제품군에서 구별되는 기능은 그라운딩 검색으로, 프롬프트에 설명한 장면에만 의존하지 않고 최신 정보를 요청에 반영할 수 있습니다.
현실 정보와 시각 기획
제작사는 현재 날씨, 최근 스포츠 행사나 역사적 배경 같은 주제의 웹 검색을 문서화합니다. 이미지에 관련된 실제 장소, 사건·시간을 식별한 뒤 예술적 표현을 별도로 설명하세요. 그라운딩 날씨 카드 콘셉트는 도시, 시각화할 상태, 정확한 제목과 레이아웃을 지정할 수 있습니다. 검색은 생성을 돕지만 사실 전달물로 쓰기 전에는 매력적인 일러스트라도 화면 사실을 관련 출처와 확인해야 합니다.
공개 FLUX.2 비교에서 이 검색 기능은 [max]에 속합니다. 다른 명명 모델은 제작용 [pro], 조정 가능한 샘플링·타이포그래피용 [flex], 간결한 대화형 생성용 [klein]이라는 역할이 있습니다. 이후 수정에서 그라운딩 가능한 프로파일을 다른 버전으로 묵시적으로 바꾸지 않도록 선택 모델 이름을 결과와 함께 유지하세요.
까다로운 편집용 참조
문서상 요청 프로파일은 참조 이미지 최대 8개를 받으며 제작사 대화형 인터페이스는 별도로 10개를 허용합니다. 캐릭터 외형, 제품 디자인, 의상, 방이나 시각 스타일처럼 각 참조에 역할을 배정하세요. 한 사진의 의자와 다른 사진의 방을 결합하면서 의자 실루엣·재질을 유지할 수 있습니다. 기존 장면에서는 바꿀 물체와 빛 방향·주변 기하를 포함한 유지 디테일을 식별합니다.
제품군 예시는 배경 변경, 물체 교체, 가구 구성, 텍스트 편집과 일관된 캐릭터를 포함합니다. 직접 만든 최종 에셋 기획은 제공 시계를 접힌 짙은 색 천 위에 두고 문자판·스트랩 디자인을 유지하며 조명만 부드러운 측면광으로 바꿀 수 있습니다. 어떤 원본이 각 특징을 주는지 밝히고 결과의 문자판, 표식, 재질·반사를 함께 검토하세요. 보존 지시는 목표를 정하며 반환 이미지가 비교할 증거입니다.
글자, 색과 프롬프트 해석
FLUX.2 가이드는 주요 요소를 앞에 둔 피사체–동작–스타일–맥락 구조를 권장합니다. 빠른 콘셉트에 10–30단어, 일반 프로젝트에 30–80단어, 복잡한 장면에는 더 긴 설명을 제안합니다. 작성 권장사항이며 엄격한 문맥 제한이 아닙니다. 자연어·JSON 구조 장면 설명 모두 피사체, 위치, 빛·스타일을 정리하는 문서상 방법입니다. 구조 프롬프트는 이미지 기획이며 구조화된 텍스트 응답의 약속이 아닙니다.
화면 글자는 문구를 인용하고 위치·타이포그래피 위계를 지정하세요. 각 16진수 색을 특정 물체나 텍스트 요소와 연결합니다. 대상 없는 색 코드는 모호합니다. 제작사 가이드는 네거티브 프롬프트 대신 긍정형 설명을 사용합니다. 제목 공간이 있는 제품 장면에서는 빈 영역과 원하는 위치를 직접 설명하세요.
정확한 [max] 요청 사양은 프롬프트 업샘플링을 기본 적용합니다. 신중한 기획을 그대로 써야 할 때 disable_pup으로 확장을 끕니다. 이는 최종 이미지에서 모든 단어가 바뀌지 않고 나타난다는 주장과 별개입니다. 예상 밖 시각 결정이 지시에서 왔는지 해석에서 왔는지 평가하도록 실제 기획과 선택 설정을 결과와 함께 보관하세요.
출력과 유용한 최종 에셋
제품군 가이드는 최대 4메가픽셀 이미지, 최소 64×64의 명시적 크기와 16의 배수를 문서화합니다. 일반 용도에는 최대 2메가픽셀을 권장합니다. 정확한 [max] 프로파일은 JPEG·PNG·WebP, 기본 JPEG와 선택적 난수 시드를 명시합니다. 구도를 배치하기 전에 사용처에 맞는 출력 형태를 고르세요. 모델 이미지 생성은 완성 에셋의 크기 변경과 별개입니다.
최종 버전 선택 시 이미지, 참조, 프롬프트, 크기와 모델 정체성을 보관합니다. 제작사 FLUX.2 가이드는 서명 결과 링크가 임시이며 가져올 시간이 10분임을 경고합니다. 의도한 표시 크기에서 작은 글자, 물체 정체성, 레이아웃, 빛과 검색에서 얻은 사실을 확인하세요. 유용한 에셋은 핵심 디테일을 기획과 비교하지 않은 장면이 아니라 정확한 수정을 이어 갈 맥락을 갖춘 선택 이미지입니다.
Ailoot Ultra · 이미지 POST /v1/images/generations black-forest-labs/flux.2-max
black-forest-labs/flux.2-max시작하기
FLUX.2 [max]는 까다로운 최종 에셋과 일관된 편집을 위한 Black Forest Labs의 이미지 모델입니다. 문서상 프로파일은 시각 참조, 상세 장면 제어와 최신 주제용 웹 그라운딩을 결합하며 최대 4메가픽셀을 출력합니다.
- 허용 입력
- 텍스트 · 이미지
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 이미지 POST /v1/images/generations
- 입력
text,image- 출력
image
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 black-forest-labs/flux.2-max | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 최소 길이: 1 | 기본값— |
필드aspect_ratio | 유형string | 요건선택 사항 | 값과 한도 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | 기본값— |
필드output_format | 유형string | 요건선택 사항 | 값과 한도 png, jpeg | 기본값— |
필드n | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 1 최댓값: 1 | 기본값— |
필드input_references | 유형array | 요건선택 사항 | 값과 한도 최소 항목 수: 0 최대 항목 수: 8 | 기본값— |
필드provider | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt |
매개변수material_types | 명세text, image |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 과금 단위 | 요금 |
|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 과금 단위— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정출력 이미지 메가픽셀 | 요금표— | 예측 수량— | 과금 단위출력 이미지 메가픽셀당 | 요금 출력 · 출력 이미지 메가픽셀 · 비교 전용 추정치 $0.14 출력 이미지 메가픽셀당 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.14 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 이미지
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-max', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 이미지
반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
완료된 결과 모두 보관
완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
정산 대조를 위해 반환된 X-Client-Request-ID를 보관하세요. 실제로 반환된 task_id/asset_id 값이나 소유한 미디어 라이브러리만 조회하세요. 작업 ID로 태스크 URL을 만들거나 생성 요청을 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드created | 유형 |
필드data[].url | 유형 |
필드data[].b64_json | 유형 |
필드usage | 유형 |
별칭
모델 별칭
Ailoot Ultra black-forest-labs/flux.2-max
메서드 경로 별칭
/v1/images
관련 호출용 ID
FAQ · Black Forest Labs: FLUX.2 Max
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/images/generations·black-forest-labs/flux.2-max:text,image→image- 요청은 어떤 필드를 사용하나요?
POST /v1/images/generations·black-forest-labs/flux.2-max:model,prompt,aspect_ratio,output_format,n,input_references,provider- 어떤 제한이 적용되나요?
POST /v1/images/generations·black-forest-labs/flux.2-max:n.minimum:1;n.maximum:1