소개
FLUX.2 Dev 이미지 편집은 320억 파라미터 오픈웨이트 모델 Black Forest Labs FLUX.2 [dev]로 원본 이미지 최대 3장을 바꾸거나 합칩니다. 새 의상, 장소, 빛을 묘사하고 유지할 부분을 적으면 이미지 한 장이 나옵니다. 얼굴을 원본에 가깝게 유지하고, 서로 다른 사진 속 인물을 한 장면에 놓을 수 있으며, 원본, 프롬프트, 결과에 필터를 적용하지 않습니다.
출발 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 바꾸거나 합칠 이미지 1~3장 | FLUX.2 Dev 이미지 편집 |
| 글로 쓴 브리프뿐 | FLUX.2 Dev 텍스트→이미지 |
핵심 기능 및 하이라이트
최대 3장의 참조 이미지
프롬프트에서 언급하는 순서대로 이미지를 나열하고 image 1, image 2, image 3으로 가리키세요. 저희 테스트에서는 한 초상 속 여성과 다른 초상 속 남성이 새 장면에서 함께 춤췄고, 두 얼굴 모두 사진에 가깝게 유지되었습니다.
원본을 따라가는 구도
비율을 auto로 두면 결과가 첫 이미지의 비율을 약 100만 화소로 유지합니다. 다르게 자르거나 더 많은 화소가 필요하면 비율과 2k를 고르세요.
균일한 가격
이미지당 가격은 원본이 한 장이든 두 장이든 세 장이든, 1k든 2k든 같습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자. 무엇을 바꾸고 무엇을 그대로 둘지 적으세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 장당 최대 10 MB의 원본 이미지 1~3장이며, 프롬프트가 가리키는 순서(‘image 1’, ‘image 2’)대로 넣으세요. 또렷한 정면 사진일수록 얼굴이 잘 유지됩니다. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 첫 번째 원본 이미지의 비율을 따라 약 100만 화소로 만듭니다. 다시 자르려면 21:9부터 9:21까지 9가지 비율 중 하나를 고르세요. |
resolution | 아니요 | 1k(기본값) 또는 2k이며, 특정 화면비를 골랐을 때만 적용됩니다. auto에서는 결과가 약 100만 화소로 유지됩니다. |
seed | 아니요 | 0부터 2,147,483,647까지의 정수입니다. 프롬프트를 고쳐 가며 결과를 비교하기 쉽도록 값을 고정해 두세요. |
요금
$0.023 / 장
원본 이미지 수나 크기 단계와 관계없이 이미지 단위 균일가로 과금합니다. 실패한 요청에는 요금이 부과되지 않습니다.
활용 사례
같은 인물의 새 의상과 장소
얼굴은 그대로 두고 사무실에서 바(bar)로, 거리에서 해변으로 인물을 옮기면서 의상과 빛을 바꿉니다.
한 장면 속 두 사람
따로 찍은 인물 사진을 한 프레임에 모아 커플 컷이나 캐릭터 페어를 만듭니다.
조명과 색 바꾸기
hex 색상으로 새 광원을 요청하고 나머지 구도는 그대로 유지합니다.
프롬프트 가이드 및 실전 팁
유지할 것부터 말하기
‘same man, same face and beard’로 시작한 뒤 바뀔 점을 나열하세요. 길게 묘사하는 것보다 짧고 명확한 목록이 더 잘 작동합니다.
인물에 번호 붙이기
사진을 합칠 때는 ‘the woman from image 1 and the man from image 2’처럼 쓰고, 두 얼굴을 사진 그대로 유지해 달라고 요청하세요.
중요하면 프레임당 한 사람만
배경에 불필요한 인물이 생기지 않도록 ‘alone in the frame, no other people’을 덧붙이세요.
auto로 시작하기
먼저 비율을 auto로 두세요. 내용이 마음에 들면 비율과 2k를 고르고, seed를 유지해 큰 버전과 비교하세요.
선명한 원본 쓰기
밝고 정면을 향한 사진일수록 얼굴이 잘 옮겨집니다. 두 번째와 세 번째 인물은 첫 번째보다 조금 덜 안정적입니다.
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-dev/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 레퍼런스에서 확인하세요.
























