Source: https://ailoot.ai/models/ko/black-forest-labs-flux-2-pro/ Canonical: https://ailoot.ai/models/ko/black-forest-labs-flux-2-pro/ Language: ko # Black Forest Labs: FLUX.2 Pro [Markdown](https://ailoot.ai/models/ko/black-forest-labs-flux-2-pro/index.md) · [JSON](https://ailoot.ai/models/ko/black-forest-labs-flux-2-pro/facts.json) ## [Black Forest Labs: FLUX.2 Pro](https://ailoot.ai/models/ko/black-forest-labs-flux-2-pro/) FLUX.2 \[pro\]는 텍스트 기반 제작과 참조 기반 편집을 위한 Black Forest Labs의 제작용 이미지 모델입니다. 문서상 프로파일은 사실적인 디테일, 글자·색상 제어, 참조·출력 픽셀 예산과 최대 4메가픽셀 이미지를 결합합니다. - [**Ailoot Ultra · 이미지** `POST /v1/images/generations` `black-forest-labs/flux.2-pro`](https://ailoot.ai/models/ko/black-forest-labs-flux-2-pro/#method-0) 모델 소개 이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다. FLUX.2 \[pro\]는 제작에 중점을 둔 Black Forest Labs의 이미지 생성·편집 모델입니다. 제조사는 텍스트에서 새 이미지를 만들거나 시각 참조로 장면을 수정하는 대부분의 FLUX.2 시각 작업에 기본 선택으로 소개합니다. 제품군 기능에는 사실적인 재질·조명, 읽을 수 있는 글자, 정확한 색 지시와 관련 편집 간 피사체 일관성이 포함됩니다. 반환 에셋은 제품 장면, 편집 디자인 구성, 디자인 콘셉트나 시각적 커뮤니케이션에 사용할 이미지입니다. #### 제작 기획 준비 피사체, 동작이나 배치, 스타일, 배경이나 빛부터 시작하세요. 제조사 프롬프트 가이드는 앞쪽 단어에 더 주목하며 장식적 디테일보다 핵심 피사체·동작을 먼저 배치하도록 권장합니다. 빠른 콘셉트에 10–30단어, 일반 프로젝트에 30–80단어, 복잡한 장면에는 더 긴 설명을 제안합니다. 이 범위는 프롬프트 작성 안내이며 텍스트 문맥 제한이 아닙니다. 직접 만든 카탈로그 기획은 따뜻한 회색 탁자 위 헤어라인 스틸 램프를 스위치·갓이 드러나는 3/4 시점으로 보여 줄 수 있습니다. 제품을 알아볼 수 있게 하는 표면, 조명과 시점을 지정하세요. 인포그래픽이나 마케팅 이미지에서는 화면 문구와 위계를 먼저 정합니다. 정확한 제목을 인용하고 위치, 글자 스타일·크기를 명시하세요. 최종 표시 크기에서 라벨, 수량과 제품 디테일을 확인합니다. 제품군 가이드는 자연어와 JSON 구조 프롬프트를 모두 문서화합니다. 구조화한 장면 기획은 피사체, 배경, 빛과 구도를 별도 필드로 두어 한 요구를 명확히 수정할 수 있습니다. 16진수 색 설명도 지원하므로 색을 적용할 특정 물체·텍스트와 코드를 연결하세요. 문서상 FLUX.2 프롬프트 흐름에는 네거티브 프롬프트가 없으므로 원하는 모습을 긍정형으로 설명합니다. #### 참조와 공통 픽셀 예산으로 편집 정확한 \[pro\] 요청 프로파일은 참조 이미지 위치 8개를 제공하며 제작사의 대화형 인터페이스는 별도로 10개를 지원합니다. 각 사진에 피사체 외형, 의상, 제품 디자인, 방이나 스타일 같은 역할을 배정하세요. 기존 장면에서는 바꿀 요소와 유지할 구도, 주변 환경·시각 디테일을 명시합니다. 공개 예시에는 가구 합성, 배경·날씨 변경, 물체 교체와 텍스트 수정이 있습니다. 참조 용량은 출력 크기에도 달려 있습니다. 제작사의 \[pro\] 가이드는 입력·출력을 합쳐 9메가픽셀 총예산을 명시합니다. 예시는 출력 1메가픽셀에서 참조 8개, 2메가픽셀에서 7개를 허용해 요청 결과가 커지면 참조 용량이 줄어듭니다. 모든 출력 크기에서 최대 슬롯을 쓸 수 있다고 취급하지 말고 원본 세트와 출력을 함께 계획하세요. 필요한 정보를 정하는 참조를 쓰고 의도한 기여를 식별합니다. 제품 합성에서는 첫 이미지가 제품, 두 번째가 방, 세 번째가 재질 마감을 제공할 수 있습니다. 하나의 일관된 장면으로 어떻게 결합할지 설명하세요. 유지하려던 형태, 표식이나 정체성이 바뀌면 기획 전체를 바꾸지 말고 후속 작업에서 그 문제에 집중합니다. 실용적인 결과는 입력과 비교한 참조 충실도 및 특정 변경을 갖춘 수정 이미지입니다. #### 프롬프트 확장과 고정·프리뷰 프로파일 정확한 \[pro\] 사양은 프롬프트 업샘플링을 기본으로 켭니다. 신중하게 작성한 지시를 그대로 써야 할 때 disable\_pup 제어가 확장을 멈춥니다. 같은 짧은 콘셉트와 확장 설명은 다른 생성 입력이므로 버전 비교 시 선택 설정을 유지하세요. 이는 제작사 프로파일 제어이며 요청 디테일이 모두 정확히 나타남을 보장하지 않습니다. 문서는 일반 \[pro\] 엔드포인트를 고정 스냅샷으로, \[pro\] Preview를 후속 모델 개선이 도입되는 프로파일로 구별합니다. 요청·응답 형태는 같지만 내부 가중치는 다릅니다. 정확한 선택 프로파일을 이미지·참조와 함께 보관하세요. 같은 문서상 모델 선택에 의존하는 수정에서는 별도 Preview 라벨로 일반 \[pro\] 선택을 묵시적으로 대체하면 안 됩니다. #### 크기, 형식과 선택 에셋 제품군 가이드는 최대 4메가픽셀 출력, 최소 64×64의 명시적 크기와 16의 배수를 문서화합니다. 대부분의 용도에는 최대 2메가픽셀을 권장합니다. 너비·높이가 구도를 정하며 정사각형 제품 이미지, 세로 레이아웃과 넓은 편집 장면은 공간을 다르게 분배합니다. 정확한 요청은 JPEG·PNG·WebP 출력, 기본 JPEG 및 선택적 시드를 명시합니다. \[max\]에는 별도 그라운딩 검색이 있고 \[flex\]는 샘플링 단계·가이던스를 노출하며 \[klein\]은 더 작은 4개 참조 프로파일입니다. 그 제어를 \[pro\]에 가져오지 말고 필요한 작업에 맞춰 버전을 선택하세요. 선택 에셋에는 실제 이미지, 최종 프롬프트, 참조, 크기와 모델 라벨을 보관합니다. 제작사의 FLUX.2 서명 결과 링크는 10분 후 만료되므로 임시 위치에 의존하지 말고 이미지를 가져오세요. 고객용 자료에 배치하기 전에 피사체 정체성, 색, 글자, 구도와 편집 디테일을 검토합니다. **Ailoot Ultra · 이미지** `POST /v1/images/generations` `black-forest-labs/flux.2-pro` [`black-forest-labs/flux.2-pro`](https://ailoot.ai/models/ko/#m=black-forest-labs%2Fflux.2-pro&route=Ultra&caller=black-forest-labs%2Fflux.2-pro&fmt=images) Black Forest Labs /`black-forest-labs/flux.2-pro` ### 시작하기 FLUX.2 \[pro\]는 텍스트 기반 제작과 참조 기반 편집을 위한 Black Forest Labs의 제작용 이미지 모델입니다. 문서상 프로파일은 사실적인 디테일, 글자·색상 제어, 참조·출력 픽셀 예산과 최대 4메가픽셀 이미지를 결합합니다. 허용 입력 텍스트 · 이미지 결과 이미지 ### Ailoot에서 사용 가능 · 입력 및 메서드 **Ailoot Ultra · 이미지** `POST /v1/images/generations` 입력 `text`, `image` 출력 `image` | 필드 | 유형 | 요건 | 값과 한도 | 기본값 | | --- | --- | --- | --- | --- | | 필드`model` | 유형`string` | 요건필수 | 값과 한도 black-forest-labs/flux.2-pro | 기본값— | | 필드`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.06** 출력 이미지 메가픽셀당 | | 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 **$0.06** 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. | Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. [금액 확보와 정산 방식 →](https://ailoot.ai/docs/ko/billing/reserve/) ### 요청 예제 #### Ailoot Ultra · 이미지 curl ```bash 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-pro', '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"