소개
FLUX.2 [pro] 편집은 Black Forest Labs의 FLUX.2 [pro]를 이미 가지고 있는 이미지에 적용합니다. 원본 1~3장을 받아 설명한 변경을 적용하고, 원본 비율 또는 9가지 비율 중 하나로 1k 또는 2k 결과를 돌려줍니다.
시작 자료에 맞춰 모드를 고르세요
| 가진 자료 | 모드 |
|---|---|
| 글로 쓴 기획안 | FLUX.2 [pro] 텍스트→이미지 |
| 바꾸거나 합칠 이미지 1~3장 | FLUX.2 [pro] 편집 |
핵심 기능 및 하이라이트
다중 참조 합성
인물, 제품, 장소를 서로 다른 사진에서 가져와 합칩니다. 저희 헤드폰 광고에서는 얼굴, 머리, 카디건과 헤드폰의 디자인이 원본 그대로 유지되었습니다.
장면과 빛 변경
피사체는 그대로 두고 배경을 바꾸거나 사진을 다시 조명합니다. 저희 맑은 낮의 거리는 블레이저에 빗방울이 맺힌 비 오는 네온의 밤이 되었습니다.
편집 중에 글자 추가
같은 단계에서 이미지에 헤드라인을 넣을 수 있습니다. 저희 헤드라인은 따옴표로 묶은 그대로 나왔습니다.
이미지당 균일가
원본이 한 장이든 세 장이든, 1k든 2k든 편집 가격은 같습니다.
인물에 엄격함
저희 테스트에서는 약함 단계의 의상 변경이라도 인물 사진 원본은 거절되었습니다. 거절된 요청에는 과금되지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 5,000자. 바꿀 내용과 그대로 둘 내용을 적고, 원본은 업로드 순서대로 image 1, image 2, image 3으로 부르세요. 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.058 / 장
원본 수나 크기 단계와 관계없이 이미지당 균일가로 과금됩니다. 거부되거나 실패한 요청에는 요금이 청구되지 않습니다.
활용 사례
별도 소재로 만드는 광고
모델 사진, 제품 컷, 장소를 하나의 비주얼로 합칩니다.
분위기 변주
클라이언트가 방향을 고를 수 있도록 같은 장면을 낮, 밤, 비 오는 날씨로 보여 줍니다.
제품·장소 리스타일링
제품, 방, 인물 사진의 배경, 조명 또는 스타일을 바꿉니다.
프롬프트 가이드 및 실전 팁
원본에 번호를 붙이세요
업로드 순서대로 image 1은 인물, image 2는 제품, image 3은 장소라고 알려 주세요.
그대로 둘 것을 적으세요
변경 내용 뒤에, 그대로 유지되어야 하는 얼굴, 의상, 자세, 디자인을 나열하세요.
한 번에 하나씩 바꾸세요
분명한 변경 하나만 주면 나머지 프레임이 안정적입니다. 여러 변경을 한꺼번에 담지 말고 편집을 이어서 하세요.
시간을 넉넉히 두세요
저희 테스트에서 편집은 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-pro/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 레퍼런스에서 확인하세요.
























