소개
FLUX.2 [pro] 텍스트→이미지는 2025년 11월 25일에 출시된 FLUX.2 세대의 Black Forest Labs 프로덕션 모델입니다. 글로 쓴 프롬프트를 사진 같은 이미지로 바꾸며, 1k 또는 2k 크기에 9가지 화면비를 지원합니다. 이미지 속 글자가 정확히 읽히고 색은 16진수 값으로 지정할 수 있습니다.
시작 자료에 맞춰 모드를 고르세요
| 가진 자료 | 모드 |
|---|---|
| 글로 쓴 기획안 | FLUX.2 [pro] 텍스트→이미지 |
| 바꾸거나 합칠 이미지 1~3장 | FLUX.2 [pro] 편집 |
핵심 기능 및 하이라이트
이미지 속에서 읽히는 글자
단어를 따옴표로 묶고 위치를 알려 주세요. 저희 포스터 테스트에서는 세리프 헤드라인과 작은 산세리프 한 줄이 모두 쓴 그대로 나왔습니다.
16진수 색상 제어
색을 16진수 값으로 적으면 팔레트가 따라옵니다. 저희 포스터는 청록과 구리 톤을 썼고, 바다와 수평선 띠가 그 색을 받아들였습니다.
다큐멘터리 같은 사실감
피부 질감, 창가의 빛, 필름 그레인이 사진처럼 읽힙니다. 저희 발코니 인물 사진은 2k에서도 주근깨와 잔주름을 유지했습니다.
모더레이션 적용, 제한 있음
약함 단계는 렌더링됩니다. 저희 테스트에서 보통 단계는 어떤 실행에서는 렌더링되었고 다른 실행에서는 수위가 낮춰져 돌아왔습니다. 강함 단계 요청은 수위가 낮춰져 돌아왔고, 매우 강함 단계는 과금 없이 거절되었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 5,000자. 피사체, 의상, 장소, 빛, 렌즈를 평범한 문장으로 적으세요. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 9가지 비율 중 하나: 1:1(기본값), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. 비율은 가격을 바꾸지 않습니다. |
resolution | 아니요 | 1k(기본값)는 약 100만 화소이고, 2k는 긴 변이 2048픽셀입니다. 크기 단계는 가격에 영향을 줍니다. |
seed | 아니요 | 0부터 2147483647 사이의 정수이며 선택 사항입니다. 프롬프트를 바꾸면서 같은 값을 쓰면 변형을 나란히 비교하기 쉽지만, 똑같은 이미지를 보장하지는 않습니다. |
요금
크기 단계별로 이미지당 과금되며, 화면비는 가격을 바꾸지 않습니다. 거부되거나 실패한 요청에는 요금이 청구되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.03 / 장 |
| $0.0391 / 장 |
활용 사례
포스터와 캠페인 시안
향수, 패션, 제품 콘셉트용으로 헤드라인과 태그라인, 사진을 한 프레임에 담습니다.
커플·캐릭터 인물
이야기, 무드보드, 캐릭터 시트용으로 머리, 의상, 분위기가 뚜렷이 다른 두 사람을 꾸밈없는 장면에 담습니다.
어떤 비율이든 소셜 비주얼
같은 프롬프트에서 비율만 바꿔 정사각형, 세로, 가로, 초와이드 프레임을 만듭니다.
프롬프트 가이드 및 실전 팁
완결된 문장으로 쓰세요
피사체, 의상, 장소, 빛, 렌즈를 키워드 나열이 아니라 문장으로 적는 편이 더 잘 통합니다.
글자는 따옴표로 묶고 서체 느낌을 알려 주세요
각 줄을 따옴표로 묶고, 예를 들어 상단의 자간이 넓은 세리프 헤드라인처럼 글자 스타일을 설명하세요.
팔레트를 고정하세요
중요한 두세 가지 색의 16진수 값을 적고 어디에 나타나야 하는지 알려 주세요.
1k로 시안을 잡으세요
1k로 구도를 시험하고, 마음에 드는 것만 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-pro/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 레퍼런스에서 확인하세요.
























