소개
FLUX.2 [max] 편집은 Black Forest Labs의 최상위 품질 FLUX.2 모델을 이미 가지고 있는 사진에 적용합니다. 원본 1~3장과 지시문을 받아 첫 번째 원본의 비율 또는 9가지 화면비 중 하나로, 1k 또는 2k 이미지를 돌려줍니다.
시작 자료에 맞춰 모드를 고르세요
| 가진 자료 | 모드 |
|---|---|
| 글로 쓴 기획안 | FLUX.2 Max 텍스트→이미지 |
| 바꾸거나 합칠 사진 1~3장 | FLUX.2 Max 편집 |
핵심 기능 및 하이라이트
최대 3장의 참조 이미지
서로 다른 사진 속 인물과 장소를 한 번의 요청으로 합칩니다. 저희 서점 테스트에서는 인물 사진 두 장과 공간 사진 한 장이 하나의 장면이 되었고, 얼굴·헤어스타일·의상은 그대로 유지되었으며 서점의 램프 불빛이 두 여성 모두에게 드리웠습니다.
배경과 빛 변경
스튜디오 배경을 황금빛 시간대의 항구로 바꾸고 인물을 다시 조명하되, 얼굴·수염·표정·옷은 그대로 둡니다.
편집당 단일 가격
편집은 원본 수와 크기 단계에 상관없이 이미지당 하나의 가격으로 청구됩니다. 거부된 요청에는 요금이 청구되지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자. 바꿀 내용과 그대로 둘 내용을 적으세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 원본 이미지 1~3장, 장당 최대 10MB. 인물, 공간, 제품처럼 각각이 무엇을 담당하는지 프롬프트에 적으세요. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 첫 번째 원본 이미지의 비율을 약 100만 화소로 유지합니다. 또는 21:9부터 9:21까지 9가지 비율 중 하나를 고르세요. |
resolution | 아니요 | 1k(기본값) 또는 2k이며 비율을 직접 골랐을 때만 적용됩니다. auto에서는 결과가 약 100만 화소로 유지됩니다. |
seed | 아니요 | 0부터 2147483647 사이의 정수이며 선택 사항입니다. 같은 프롬프트와 원본에 같은 값을 쓰면 변경 효과를 비교하기 쉽지만, 똑같은 이미지를 보장하지는 않습니다. |
요금
$0.076 / 장
원본 이미지 수나 크기 단계와 관계없이 편집 한 번에 이미지당 하나의 가격으로 과금됩니다. 실패하거나 거부된 요청에는 요금이 청구되지 않습니다.
활용 사례
제품·장소 사진
카탈로그와 캠페인 이미지를 위한 새 배경, 새 조명, 일관된 장면입니다.
일상 인물 사진 보정
인물이 알아볼 수 있는 상태를 유지하면서 일상적인 인물 사진의 배경, 조명, 스타일을 바꿀 수 있습니다.
따로 찍은 사진으로 만드는 단체 장면
개별 인물 사진 속 사람들을 하나의 방이나 장소로 불러옵니다.
프롬프트 가이드 및 실전 팁
그대로 둘 것을 말하세요
변경 내용 뒤에, 움직이면 안 되는 얼굴·머리·옷·자세를 나열합니다.
원본에 번호를 붙이세요
업로드한 순서대로 image 1, image 2, image 3이라고 부르고 각각에 역할을 줍니다.
깨끗한 일상 원본 사진을 쓰세요
편집은 필터가 엄격합니다. 저희 테스트에서 Max는 약함 단계에서도 인물 사진 편집을 거부했습니다. 제품, 장소, 단정한 옷차림의 인물 사진이 안전한 소재입니다.
프레임을 유지하려면 auto를 고르세요
auto는 첫 번째 원본의 비율을 유지합니다. 다른 크롭이나 2k가 필요할 때 비율과 크기 단계를 직접 고르세요.
최대 2분까지 여유를 두세요
저희 편집은 약 45~120초가 걸렸습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-max/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.

























