소개
FLUX.2 Dev 텍스트→이미지는 2025년 11월 25일 오픈웨이트로 공개된 320억 파라미터 모델 Black Forest Labs FLUX.2 [dev]로 글 프롬프트에서 이미지를 만듭니다. 이미지 안에 읽히는 글자를 넣고 hex 색상 코드를 따르며, 1k에서는 약 100만 화소, 2k에서는 긴 변 최대 2048픽셀의 결과를 9가지 화면비로 돌려줍니다. 프롬프트와 결과에는 필터가 적용되지 않습니다.
출발 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | FLUX.2 Dev 텍스트→이미지 |
| 바꾸거나 합칠 이미지 1~3장 | FLUX.2 Dev 이미지 편집 |
핵심 기능 및 하이라이트
철자 그대로 나오는 글자
저희 테스트에서 간판, 네온, 라벨의 짧은 따옴표 글자가 올바르게 나왔습니다. 가게 문의 ‘CLOSED’ 간판과 ‘VACANCY’ 네온 사인 모두 적은 그대로의 철자였습니다.
hex 색상 제어
묘사하는 빛이나 사물 옆에 #FF4F8B, #3AA7FF 같은 코드를 적으세요. 강한 힌트이므로 정확한 브랜드 색 일치보다는 분위기와 조명에 알맞습니다.
필터는 없고, 모델 고유의 한계는 있습니다
어떤 것도 검토되거나 거절되지 않습니다. 저희 테스트에서 약함, 보통, 강함, 최대 단계는 매번 나왔지만, 매우 강함 단계는 수위가 낮춰진 채 돌아왔습니다. 그 단계에 맞는 모델은 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자. 피사체, 의상, 장소, 빛, 카메라 느낌을 완전한 문장으로 묘사하세요. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 21:9부터 9:21까지 9가지 비율이며 기본값은 1:1입니다. 작은 크기 단계에서는 약 100만 화소로, 16:9라면 1344 x 768이고, 큰 단계에서는 긴 변이 2048픽셀에 이릅니다. |
resolution | 아니요 | 1k(기본값)는 약 100만 화소이고, 2k는 긴 변이 2048픽셀에 이릅니다. 두 단계의 가격은 같습니다. |
seed | 아니요 | 0부터 2,147,483,647까지의 정수입니다. 프롬프트의 한 부분만 바꿔 가며 결과를 비교하기 쉽도록 값을 고정해 두세요. |
요금
이미지 단위로 과금합니다. 1k와 2k의 가격이 같으며 화면비도 가격에 영향을 주지 않습니다. 실패한 요청에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.0116 / 장 |
| $0.0116 / 장 |
활용 사례
인물 사진과 라이프스타일 스틸
무드보드, 표지, 캐릭터 레퍼런스에 쓸 수 있는, 그럴듯한 배경 속 한두 사람의 필름 스타일 사진입니다.
간판, 포스터, 라벨
쇼윈도, 네온 사인, 패키지, 포스터처럼 몇 단어가 읽혀야 하는 장면에 알맞습니다.
모더레이션이 없는 플랫폼
이용자가 프롬프트에 대한 검토 없이 쓰기를 기대하는 서비스용입니다. 약함부터 최대까지의 단계는 매우 강함을 제외하고 모두 사용할 수 있습니다.
프롬프트 가이드 및 실전 팁
사진 촬영 브리프처럼 쓰기
피사체, 의상, 장소, 빛, 필름 룩을 완전한 문장으로 적으세요. FLUX.2는 긴 프롬프트를 잘 따릅니다.
글자는 따옴표로, 위치도 지정
정확한 문구를 따옴표 안에 넣고 놓일 위치를 적으세요. 몇 단어 안쪽으로 유지하세요. 긴 문단에는 여전히 오류가 있을 수 있습니다.
빛과 그 색을 이름 붙이기
‘warm #E9A23B tungsten lamps’나 ‘pink neon washing the room in #FF4F8B’처럼 쓰면 장면에 분명한 색 방향이 생깁니다.
최종본은 2k로
아이디어는 1k로 시험하고, 마음에 드는 것을 같은 seed로 2k에서 다시 렌더링해 비교하세요. 가격은 두 단계 모두 같습니다.
인물이 입은 옷을 적기
특정 의상을 원한다면 그것을 적어 주세요. 저희 테스트에서 모델은 프롬프트에 적힌 의상 묘사를 따랐습니다.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# 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 레퍼런스에서 확인하세요.
























