모델

Black Forest Labs: FLUX.3 Image

Markdown · JSON

Black Forest Labs: FLUX.3 Image

FLUX 3 Image는 글로 쓴 기획과 참조 최대 10개에서 이미지를 생성·편집합니다. 구도·국소 변경을 위한 프롬프트 기반 바운딩 박스, 웹·이미지 그라운딩과 해상도 등급 5개를 추가합니다.

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

FLUX 3 Image는 구도를 명시적으로 제어하는 Black Forest Labs의 이미지 생성·편집 모델입니다. 텍스트 설명으로 새 장면을 만들고 제공 이미지로 피사체, 수정 장면이나 결합할 여러 요소를 정할 수 있습니다. 바운딩 박스를 통해 각 요소의 위치와 기존 이미지에서 변경할 부분을 기획에 지정합니다. 결과는 요청 장면, 글자와 레이아웃을 확인할 이미지입니다.

장면 제작 또는 편집 지시

새 이미지에서는 피사체, 동작이나 포즈, 배경, 빛·구도를 설명하세요. 이미지 안의 정확한 문구를 따옴표에 넣고 위치를 명시합니다. 직접 만든 제품 기획은 옅은 돌 표면의 빨간 캠핑 머그 위에 큰 제목을 두고 부드러운 아침 빛으로 손잡이를 드러낼 수 있습니다. 무관한 스타일 단어를 주기보다 제목·제품·배경 관계를 정의하세요.

편집에서는 머그 색 변경, 라벨 교체, 인물 이동이나 장면 스타일 변경처럼 특정 물체·변경을 식별합니다. 단일 편집에 손으로 그린 박스가 필수는 아닙니다. 문서상 워크플로는 생성 전에 지시를 확장하고 명명된 요소를 찾아 자동으로 박스를 추가할 수 있습니다. 반환 확장 프롬프트는 그 해석을 기록하며 잘못된 물체를 선택하거나 불필요한 디테일을 넣었을 때 유용합니다.

참조 이미지 결합과 준비

정확한 제작사 프로파일은 이미지 URL이나 인코딩 이미지 데이터로 참조 1–10개를 받습니다. 각각 최소 256×256픽셀, 최대 16메가픽셀입니다. 위치나 보이는 내용으로 참조를 명명하고 Image 1의 인물, Image 2의 재킷, Image 3의 방처럼 역할을 설명하세요. 이미지 참조는 시각 정보의 원본이며 포함된 모든 무관한 디테일을 복사하라는 지시가 아닙니다.

화면비 기본값은 auto입니다. 요청 사양에서는 프롬프트에서 요청한 비율이 우선하고, 없으면 첫 참조가 구도를 정하며 둘 다 없으면 정사각형으로 대체됩니다. 합성에서는 의도한 장면 참조를 먼저 두거나 비율을 명시적으로 선택하세요. 이후 수정에 같은 시각적 출발점을 쓰도록 원본 이미지와 순서를 결과와 함께 보관합니다.

바운딩 박스로 요소 배치

레이아웃 프롬프트는 캡션과 요소 행의 JSON 배열을 결합합니다. 캡션은 <cup_1> 같은 마커로 요소를 명명하며 행에는 id, bbox, desc가 들어갑니다. 좌표는 왼쪽 위 모서리 기준 0–1000 정수이며 [top, left, bottom, right] 순서입니다. 예를 들어 [0, 0, 500, 500]은 픽셀 크기와 무관하게 왼쪽 위 1/4을 뜻합니다. 좌표 격자가 프레임에 따라 늘어나므로 레이아웃을 설계한 화면비를 사용하세요.

편집 행은 식별자·설명과 함께 from, src_bbox, tgt_bbox를 사용합니다. ref_image_0은 첫 제공 이미지입니다. 원본·목표 박스가 같으면 요소를 고정하고 다르면 이동·크기 변경합니다. 원본 없는 새 행은 목표 위치에 설명을 생성해 추가·교체·색 변경이 가능합니다. 목표 없는 원본 행은 요소를 제거합니다. 추가·제거를 글 지시와 행 모두에 명시하고 제자리에 있어야 할 디테일의 고정 행을 유지하세요.

글자에는 자체 박스를 주고 desc에 정확한 문구를 인용합니다. 박스는 위치·크기를 안내하며 클리핑 마스크가 아니므로 요소가 사각형 밖으로 나갈 수 있습니다. 제작사는 예시에서 약 40×25픽셀 박스의 새 물체가 종종 나타나지 않았다고 보고합니다. 눈에 보이는 공간을 충분히 주고 편집 경계를 확인하세요. 목표 밖 픽셀은 대체로 안정적이지만 그림자, 반사와 주변 조명은 바뀔 수 있습니다.

그라운딩, 출력 등급과 유용한 기록

문서상 프로파일은 그라운딩을 기본으로 켜 웹·이미지 검색으로 생성을 돕습니다. 제공 설명·참조만 쓸 기획에서는 끌 수 있습니다. 현실 피사체는 장소, 사건·물체를 명확히 식별하고 사실 내용과 예술적 처리를 구분하세요. 라벨, 물체나 묘사한 사건이 정확해야 한다면 검색을 반영한 이미지도 신뢰할 자료와 비교해야 합니다.

해상도 등급 5개는 768sq, 1k, 1.5k, 2k, 4k이며 기본값은 1k입니다. 같은 픽셀 면적 등급을 뜻하므로 정확한 너비·높이는 선택 비율에 달려 있습니다. 고정 비율 15개는 21:9부터 정사각형·세로를 거쳐 9:21까지입니다. 이 모델은 비율·해상도로 크기를 제어하며 FLUX.2 요청 프로파일의 seed, width, height 필드를 제공하지 않습니다. 문서상 버전 선택기는 현재 날짜로 고정된 공급사 가중치 일치가 아니라 계속 바뀌는 릴리스를 명명합니다.

제작사 워크플로는 비동기 처리 후 이미지와 확장 프롬프트를 함께 반환합니다. 서명 이미지 다운로드 링크는 1시간 유효합니다. 임시 링크에 의존하지 말고 실제 이미지, 최종 프롬프트·참조를 보관하세요. 검토 에셋에서는 의도한 표시 크기로 요청 글자, 물체 배치, 참조 정체성·변경 영역을 비교합니다. 완료 생성은 그 시각 요구를 확인하는 출발점입니다.

Ailoot Ultra · 이미지 POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

시작하기

FLUX 3 Image는 글로 쓴 기획과 참조 최대 10개에서 이미지를 생성·편집합니다. 구도·국소 변경을 위한 프롬프트 기반 바운딩 박스, 웹·이미지 그라운딩과 해상도 등급 5개를 추가합니다.

허용 입력
텍스트 · 이미지
결과
이미지

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 이미지 POST /v1/images/generations
입력
text, image
출력
image
필드유형요건값과 한도기본값
필드model유형string요건필수값과 한도
black-forest-labs/flux-3-image
기본값—
필드prompt유형string요건필수값과 한도
최소 길이: 1
기본값—
필드resolution유형string요건선택 사항값과 한도
768, 1K, 1.5K, 2K, 4K
기본값—
필드aspect_ratio유형string요건선택 사항값과 한도
21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto
기본값—
필드n유형integer요건선택 사항값과 한도
최솟값: 1
최댓값: 1
기본값—
필드input_references유형array요건선택 사항값과 한도
최소 항목 수: 0
최대 항목 수: 10
기본값—
필드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 토큰
설정예상 생성 비용요금표—예측 수량1회 생성 예상치요금
출력 · 예상 생성 비용 · 비교 전용 추정치 $0.082 생성 전 추정치

이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 이미지

curl
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-3-image', '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}/content
  • GET /v1/media/assets
  • GET /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-3-image

메서드 경로 별칭

/v1/images

관련 호출용 ID

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image
어떤 입력과 결과를 사용할 수 있나요?

POST /v1/images/generations · black-forest-labs/flux-3-image: text, image → image

요청은 어떤 필드를 사용하나요?

POST /v1/images/generations · black-forest-labs/flux-3-image: model, prompt, resolution, aspect_ratio, n, input_references, provider

어떤 제한이 적용되나요?

POST /v1/images/generations · black-forest-labs/flux-3-image: n.minimum: 1; n.maximum: 1

자세히 보기

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독
정기 요청에 맞는 할인 요금제를 선택하세요.
최대 50% 프로모션 코드
구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.
이력의 지출
요청마다 모델, 토큰, 금액을 저장합니다.

구독 선택 · 모델 가격 보기

판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱
서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.
리셀러 라이선스
프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.
사이트의 문서
연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

리셀러 라이선스 요청 · 공식 이용 조건과 라이선스 계약