소개
FLUX.2 [flex] 편집은 Black Forest Labs의 FLUX.2 [flex]를 이미 가지고 있는 이미지에 적용합니다. 원본 1~3장과 새 조명, 새 장면, 글자 추가 같은 지시문을 받아 원본 비율 또는 9가지 비율 중 하나로 1k 결과를 돌려줍니다.
시작 자료에 맞춰 모드를 고르세요
| 가진 자료 | 모드 |
|---|---|
| 글로 쓴 기획안 | FLUX.2 [flex] 텍스트→이미지 |
| 바꾸거나 합칠 이미지 | FLUX.2 [flex] 편집 |
핵심 기능 및 하이라이트
피사체는 그대로, 조명만 새로
저희 테스트에서 낮의 인물 사진이 젖은 돌바닥, 상점 진열창 불빛, 빗방울이 있는 비 오는 밤이 되었고, 여성과 코트, 자세는 그대로 유지되었습니다.
여러 원본을 합성
원본마다 번호로 부르고 어떻게 합칠지 알려 주세요. 저희 향수 테스트에서는 한 사진의 병을 다른 사진의 대리석 선반에 올리고 빛과 반사를 맞췄습니다.
결과물 위에 글자 추가
더하고 싶은 헤드라인이나 라벨은 따옴표로 묶으세요. 저희 합성 결과에는 헤드라인이 쓴 그대로 나왔고, 라벨의 ‘No.’는 번호 기호로 나올 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자. 바꿀 내용과 그대로 둘 내용을 적고, 각 원본은 image 1, image 2처럼 순서로 부르세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 원본 이미지 1~3장, 프롬프트에서 부르는 순서대로 올리세요. 원본 수와 관계없이 가격은 같습니다. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 첫 번째 원본의 크기와 비율을 대략 유지합니다. 또는 21:9부터 9:21까지 9가지 비율 중 하나를 고르세요. |
resolution | 아니요 | 편집에서는 1k만 제공합니다. 비율을 고정했을 때 적용되며, auto에서는 결과가 첫 번째 원본의 크기를 따릅니다. |
seed | 아니요 | 0부터 2147483647 사이의 정수이며 선택 사항입니다. 같은 프롬프트와 원본에 같은 값을 쓰면 변형을 나란히 비교하기 쉽습니다. |
요금
$0.115 / 장
이미지당 균일가 하나로 과금되며, 원본 이미지 수와 화면비는 가격을 바꾸지 않습니다. 거부되거나 실패한 요청에는 요금이 청구되지 않습니다.
활용 사례
제품 장면
패키지 컷을 연출한 장소로 옮기고 라벨이나 헤드라인을 더합니다.
분위기와 날씨 변주
방향을 고르는 고객에게 황혼, 빗속, 네온 아래의 인물 사진 한 장을 보여 주십시오.
풍경과 일상 이미지
풍경이나 거리 장면의 시간대, 계절, 배경을 바꿉니다.
프롬프트 가이드 및 실전 팁
그대로 둘 것을 말하세요
변경 내용 뒤에, 그대로 유지되어야 하는 얼굴, 옷차림, 자세를 나열하세요.
원본에 번호를 붙이세요
프롬프트에 image 1, image 2라고 적어 각 원본의 역할을 분명히 하세요.
업무용으로 안전한 소재만 쓰세요
편집은 약함 단계에서도 텍스트→이미지보다 인물 사진을 훨씬 쉽게 거부하므로, 제품, 풍경, 일상적인 인물 사진에 사용하십시오.
프레임을 유지하려면 auto를 고르세요
auto에서는 결과가 첫 번째 원본의 크기를 따릅니다. 다시 구도를 잡고 싶을 때만 고정 비율을 고르세요.
1~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-flex/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 레퍼런스에서 확인하세요.

























