소개
FLUX.2 [flex] 텍스트→이미지는 2025년 11월 25일에 출시된 글자와 레이아웃을 위한 Black Forest Labs의 FLUX.2 모델입니다. 글로 쓴 프롬프트를 그림으로 바꾸고, 따옴표로 묶은 글자를 쓴 그대로 넣으며, 16진수 색상 코드를 따르고, 1k 또는 2k에 9가지 비율로 렌더링합니다.
시작 자료에 맞춰 모드를 고르세요
| 가진 자료 | 모드 |
|---|---|
| 글로 쓴 기획안 | FLUX.2 [flex] 텍스트→이미지 |
| 바꾸거나 합칠 이미지 | FLUX.2 [flex] 편집 |
핵심 기능 및 하이라이트
쓴 그대로 돌아오는 글자
저희 테스트에서 제목, 태그라인, 개봉 문구가 들어간 영화 포스터, 스크립트체 제목의 앨범 커버, 차 통 라벨은 따옴표로 묶은 모든 줄이 정확한 철자로 나왔습니다.
16진수 코드로 색 지정
큰 사물, 배경, 색보정 옆에 코드를 적으면 렌더링이 그 색에 가깝게 유지됩니다. 아주 작은 글자에서는 색조가 달라질 수 있습니다.
두 가지 크기, 아홉 가지 비율
1k는 약 100만 화소이고 2k는 긴 변 2048픽셀로 렌더링하며, 21:9 배너부터 9:21 스토리까지 고를 수 있습니다. 2k가 1k보다 비싸고, 비율은 가격을 바꾸지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자. 피사체, 장소, 빛, 스타일을 평범한 문장으로 적으세요. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 21:9부터 9:21까지 9가지 비율 중 하나이며 기본값은 1:1입니다. 비율은 가격을 바꾸지 않습니다. |
resolution | 아니요 | 1k(기본값)는 약 100만 화소이고, 2k는 긴 변 2048픽셀로 렌더링합니다. 2k가 1k보다 비쌉니다. |
seed | 아니요 | 0부터 2147483647 사이의 정수이며 선택 사항입니다. 같은 프롬프트에 같은 값을 쓰면 변형을 나란히 비교하기 쉽습니다. |
요금
크기 단계별로 이미지당 과금되며 2k가 1k보다 비싸고 화면비는 가격을 바꾸지 않습니다. 거부되거나 실패한 요청에는 요금이 청구되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.0578 / 장 |
| $0.0881 / 장 |
활용 사례
포스터와 커버
글자가 디자인의 일부인 영화 포스터, 앨범 커버, 매거진 제호입니다.
패키지와 제품 컷
특정 브랜드 색을 쓴 라벨, 통, 병을 연출한 장소에서 촬영한 컷입니다.
광고 헤드라인
조명이 들어간 장면 위에 헤드라인과 카피 한 줄을 얹어 피치나 첫 레이아웃에 바로 쓸 수 있습니다.
프롬프트 가이드 및 실전 팁
모든 줄을 따옴표로 묶고 위치를 정하세요
글자 한 줄 한 줄을 따옴표로 묶고 위치를 알려 주세요. 마지막에 ‘No other text’를 적으면 불필요한 단어가 생기는 것을 막을 수 있습니다.
색은 코드로 주세요
사물 이름과 16진수 값을 함께 적으세요. 예를 들어 크림색 #F3E9D2 라벨에 금색 #C9A227 테두리처럼요.
인물은 옷차림과 자세로 설명하세요
각 인물이 입은 옷, 선 자리, 시선을 적으세요. 약함 단계의 인물 사진은 그려지고, 그보다 강한 요청은 거부되거나 누그러뜨려집니다.
글자는 2k에서 시작하세요
크기가 크면 작은 글자에도 픽셀이 더 돌아가 가독성에 도움이 됩니다. 빠른 시안은 1k를 쓰세요.
20~90초를 예상하세요
저희 테스트에서 대부분의 요청이 이 범위에서 끝났고, 대기열이 붐비면 더 걸립니다.
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/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 레퍼런스에서 확인하세요.

























