사용 가이드
flux-2-klein-9b 전자상거래 제품 이미지 생성 프롬프트 레시피
텍스트 렌더링과 고충실도 디테일을 위한 복사 가능한 프롬프트 구조, 그리고 hiapi API를 통한 curl 및 Python 요청
이 페이지에서
프롬프트 구조가 길이보다 중요한 이유
대부분의 형편없는 제품 렌더링은 형용사가 부족해서가 아니라, 프롬프트가 주체, 카메라, 조명, 텍스트 요구사항을 구분하기 어려운 한 덩어리의 단어로 뒤섞어 버리기 때문에 발생합니다. 출력이 잘못되면 어느 문장이 원인인지 판단할 수 없어, 전체를 다시 쓰면서 원래 효과가 있던 부분까지 잃게 됩니다.
구조화된 프롬프트는 이 문제를 해결합니다. 설명의 각 부분이 명확한 소속을 갖기 때문입니다. 매번 하나의 슬롯만 바꾸고 다시 렌더링하세요. 라벨 텍스트가 일그러지면 텍스트 슬롯을 바꿉니다. 병이 무광 유리가 아니라 플라스틱처럼 보이면 재질 설명을 바꿉니다. 나머지 모든 것은 그대로 두므로 반복 비용이 낮고 좋은 결과를 재현할 수 있습니다.
더 긴 프롬프트가 자동으로 충실도를 높이지는 않습니다. 일정 길이를 넘으면 추가 형용사들이 서로 경쟁하기 시작합니다: 같은 문단에 "glossy"와 "matte"가 동시에 있고, 서로 다른 두 조명 방향이 있으며, 세 가지 모두 그럴듯한 배경 색조가 있습니다. 모델은 이들을 평균낼 수밖에 없고, 평균화된 프롬프트는 평범한 이미지를 만들어냅니다. 슬롯이 명확히 분리된 짧은 프롬프트는 모델에 명확하고 모호함 없는 지시를 줍니다.
이 가이드 전체에서 다섯 슬롯 레시피 형식을 사용합니다:
- 주체 — 제품과 그 결정적인 물리적 속성
- 구도 — 프레이밍, 각도, 배치, 배경
- 조명 — 방향, 질감, 그림자 표현
- 텍스트 — 정확한 문구, 위치, 계층
- 네거티브 — 억제해야 할 아티팩트의 짧은 목록
아래 각 섹션은 특정 슬롯을 겨냥한 복사 가능한 문자열을 제공합니다. 이 문자열들을 조립해 hiapi API에서 flux-2-klein-9b/text-to-image로 실행하고, 매 반복마다 슬롯 하나만 조정합니다.
레시피 골격: 주체, 구도, 조명, 텍스트, 네거티브
템플릿은 다음과 같습니다. 대괄호 부분은 제안이 아니라 채워 넣을 필드로 취급하세요.
Subject: [제품명], [주요 재질], [표면 처리], [구분되는 디테일 하나]
Composition: [렌즈 유형] of [주체 배치], [배경 설명], [카메라 각도]
Light: [방향] [질감] light, [그림자 설명]
Text: the words "[정확한 문구]" in [글꼴 스타일], positioned [위치], sized [상대적 크기]
Negatives: [아티팩트], [아티팩트], [아티팩트]
완성된 스킨케어 제품 예시:
Subject: amber glass dropper bottle, frosted glass body, matte black cap, a thin label band near the base
Composition: product hero shot, bottle centered on a light stone surface, soft neutral background with slight gradient, eye-level camera angle
Light: large softbox from the upper left, gentle falloff toward the right, soft contact shadow under the bottle
Text: the words "DAILY SERUM" in a clean geometric sans-serif, positioned on the label band, sized to span most of the label width
Negatives: warped lettering, duplicate labels, harsh specular hotspots
이 골격을 신뢰할 수 있게 유지하는 두 가지 규칙이 있습니다. 첫째, 순서보다 분리가 더 중요합니다 — 이 레이블(Subject:, Light:)은 직접 편집할 때 규율을 유지하도록 돕기 위한 것이며, 프롬프트가 안정되면 제거해도 됩니다. 둘째, 각 슬롯에는 구체적인 서술어를 소수만 유지하세요. 한 슬롯이 두 줄을 넘는다면, 십중팔구 서로 다른 두 이미지를 설명하고 있는 것입니다.
각 콘텐츠 슬롯은 열다섯에서 마흔 단어를 목표로 하세요. 이 범위는 제품의 물리적 현실을 고정하기에 충분하면서도, 모델이 경쟁적인 해석을 지어낼 여지를 남기지 않습니다.
이미지 텍스트를 선명하게 읽히게 하는 레시피
텍스트 렌더링은 프롬프트 규율의 가치가 가장 잘 드러나는 지점입니다. 세 가지 습관이 효과를 크게 높입니다: 정확한 문구를 인용하기, 배치 위치 설명하기, 글자 수를 적게 유지하기.
한 번만, 정확하게 인용하기
원하는 문구를 따옴표 안에 넣고 한 번만 진술하세요. 서로 다른 슬롯에서 같은 문자열을 반복하면 모델이 그것을 두 번 렌더링하도록 유도합니다.
Text: the words "AURORA" in a bold condensed sans-serif, centered on the front panel, large enough to dominate the upper third
계층을 명확히 지정하기
텍스트 요소가 두 개일 때는 어느 것이 주(主)이고 어느 것이 부(副)인지 밝히고, 상대적 크기를 설명하세요.
Text: primary line "COLD BREW" in a heavy serif, centered; secondary line "single origin" in a smaller light sans-serif directly beneath it, roughly one quarter the height of the primary line
위치를 물리적 특징에 고정하기
"중앙"은 너무 약합니다. "전면 라벨 중앙, 상단 가장자리와 캡 넥 밴드 사이"는 모델에 사용할 수 있는 기하학적 정보를 제공합니다.
Text: the words "SPF 30" in a rounded sans-serif, positioned in the lower right corner of the label, small relative to the product
텍스트를 짧게 유지하기
한두 개에서 네 개의 단어는 안정적으로 렌더링됩니다. 완전한 문장, 제품 주장, 성분 목록은 가독성이 녹아내린 글자 모양으로 무너지는 바로 그 지점입니다. 포장에 실제로 문단이 필요하다면, 먼저 깨끗한 제품 이미지를 생성한 뒤 나중에 실제 타이포그래피를 합성하세요 — 모델은 레이아웃 엔진이 아닙니다.
전자상거래 라벨에 적합한 효과적인 패턴
- 짧은 브랜드 식별자:
the words "NORD" in an uppercase geometric sans-serif, tracking wide, centered on the bottle shoulder - 용량 또는 부피:
the words "250ml" in a small regular sans-serif, bottom edge of the label, right-aligned - 카테고리 단어:
the words "BODY LOTION" in a medium-weight sans-serif, one line, spanning the label width
렌더링 결과에 깨진 글자가 나타나면 가장 먼저 문자열을 줄이고, 그다음에 다른 무엇이든 바꿀지 고려하세요. 길이가 가장 흔한 실패 축입니다.
고충실도 제품 디테일 레시피
충실도는 형용사의 밀도가 아니라 물리적 구체성에서 나옵니다. 세 가지 슬롯이 대부분의 역할을 합니다: 재질, 표면 처리, 프레이밍.
재질
물질의 이름과 눈에 보이는 결과 한두 가지를 말하세요.
Subject: ceramic mug, thick stoneware body, slight irregularity along the rim, speckled clay visible through the glaze
이것을 a beautiful high-quality mug와 비교해 보세요. 후자는 모델에 렌더링할 수 있는 정보를 전혀 주지 않습니다.
표면 처리
표면 처리는 렌더링이 가장 자주 잘못되는 부분입니다. "광택"과 "고급스러움"은 실행 가능한 지시가 아니기 때문입니다. 빛이 표면에서 어떻게 작동하는지 설명하세요.
Subject: stainless steel thermos, brushed horizontal grain, satin finish that spreads highlights into wide soft bands rather than sharp points
Subject: glass perfume bottle, clear thick-walled glass, polished facets that produce crisp edges and a visible refraction through the body
프레이밍
사진 용어를 빌려오세요. 이는 모델에 일관된 렌즈 공간 모델을 제공합니다.
product hero shot, eye-level, centered, shallow depth of field with the background falling off softlythree-quarter angle, slightly above eye level, product occupying the lower two thirds of the frameflat lay, directly overhead, product aligned to the frame edges with even margins
실질적으로 유용한 질감 서술어
제품이 실제로 그럴 때만 이 단어들을 사용하세요: brushed, frosted, matte, satin, polished, woven, knurled, embossed, anodized. 각각은 특정한 조명 반응에 대응하며, 이것이 막연한 칭찬 단어보다 우수한 이유입니다.
디테일에 초점을 맞춘 완전한 주체 설명 행:
Subject: matte ceramic candle jar, unglazed exterior with fine grain, smooth glazed interior lip, thin wooden lid resting slightly ajar
여기에 최상급 형용사는 없습니다. 모든 단어가 기하학이나 빛을 제약하고 있습니다.

가중치와 짧은 네거티브 목록
단어 강조와 약화
어떤 슬롯이 무시될 때는 두 가지 지렛대가 있습니다: 해당 단어를 프롬프트에서 더 앞쪽으로 옮기거나, 가중치를 주는 것입니다. 가중치 문법은 도구마다 다르므로, 프로덕션 부하에서 특정 표기에 의존하기 전에 hiapi API의 flux-2-klein-9b/text-to-image가 무엇을 받아들이는지 먼저 확인하세요. 실제로는 재배치가 가장 이식성이 좋은 수정 방법입니다 — 슬롯 앞부분 근처의 단어가 끝에 묻힌 단어보다 더 큰 영향을 줍니다.
가중치는 실제 충돌에 사용하고, 일상적인 강조에는 쓰지 마세요. 라벨 텍스트가 계속 작아진다면 텍스트 슬롯에 가중치를 주고, 주체의 모든 단어에 가중치를 주지는 마세요.
네거티브 목록을 증거에 기반하게 만들기
네거티브 목록은 패치 목록이지 희망 목록이 아닙니다. 빈 상태로 시작하세요. 렌더링하세요. 특정 아티팩트가 보이면 추가하세요. 더 이상 보이지 않으면 제거를 고려하세요.
제품 이미지 작업에서 실용적인 시작 세트:
Negatives: warped lettering, duplicate text, extra fingers, distorted reflections
대부분의 전자상거래 프롬프트에서 이것이 유용한 상한선에 거의 해당합니다. 지나치게 긴 네거티브 목록은 두 가지 문제를 낳습니다. 첫째, 제품을 설명하는 데 쓸 수 있었던 프롬프트 예산을 소모합니다. 둘째, blurry나 low quality 같은 광범위한 네거티브 단어는 모델을 실제로 원하는 정당한 소프트 포커스 배경과 섬세한 표면 질감에서 밀어낼 수 있습니다.
아티팩트 범주별로 네거티브 단어를 추가하세요:
- 텍스트 실패:
warped lettering,duplicate text,misspelled labels - 구조 실패:
asymmetric bottle,floating product,missing lid - 조명 실패:
harsh specular hotspots,double shadows - 배경 실패:
cluttered background,visible seams
몇 번의 렌더링마다 목록을 검토하세요. 어떤 항목이 오랫동안 나타나지 않았다면 삭제하고, 그 단어 수를 다른 곳에 쓰세요.
hiapi API에서 실행하기: curl과 Python
모델 ID는 flux-2-klein-9b/text-to-image입니다. 두 클라이언트는 같은 요청 형태를 보냅니다: 모델 식별자와 조립된 프롬프트를 담은 파라미터 객체입니다. API key와 base URL을 hiapi 계정의 값으로 바꾸세요.
curl
curl -X POST "$HIAPI_BASE_URL/v1/images/generations" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-klein-9b/text-to-image",
"prompt": "Subject: amber glass dropper bottle, frosted glass body, matte black cap, thin label band near the base. Composition: product hero shot, bottle centered on a light stone surface, soft neutral gradient background, eye-level camera angle. Light: large softbox from the upper left, gentle falloff toward the right, soft contact shadow. Text: the words \"DAILY SERUM\" in a clean geometric sans-serif, on the label band, spanning most of the label width. Negatives: warped lettering, duplicate labels, harsh specular hotspots."
}'
Python
import os
import requests
payload = {
"model": "flux-2-klein-9b/text-to-image",
"prompt": (
"Subject: amber glass dropper bottle, frosted glass body, matte black cap, "
"thin label band near the base. "
"Composition: product hero shot, bottle centered on a light stone surface, "
"soft neutral gradient background, eye-level camera angle. "
"Light: large softbox from the upper left, gentle falloff toward the right, "
"soft contact shadow. "
"Text: the words \"DAILY SERUM\" in a clean geometric sans-serif, on the label band, "
"spanning most of the label width. "
"Negatives: warped lettering, duplicate labels, harsh specular hotspots."
),
}
response = requests.post(
f"{os.environ['HIAPI_BASE_URL']}/v1/images/generations",
headers={
"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}",
"Content-Type": "application/json",
},
json=payload,
timeout=120,
)
response.raise_for_status()
print(response.json())
페이로드 조정하기
프롬프트는 슬롯 변수로 만들어 조립한 단일 문자열로 유지하세요 — API 문서에서 명확히 지원하지 않는 한 슬롯마다 필드를 하나씩 보내지 마세요. 코드에서는 각 슬롯을 독립 변수로 저장한 뒤 이어 붙이면, 레시피의 나머지 부분을 건드리지 않고 SKU별로 배경이나 라벨 문구를 바꿀 수 있습니다. API 참조에서 계정의 정확한 엔드포인트 경로와 허용되는 파라미터를 확인하세요. 통합에 필요하다면 출력 크기나 시드 제어를 그곳에서 추가할 수도 있습니다.

엔드투엔드 전자상거래 제품 이미지 예시
아래는 드립백 커피를 출시하려는 커피 브랜드에 적용할 수 있는 완전하고 재사용 가능한 예시입니다. 모든 슬롯이 채워져 있고, 네거티브 목록은 짧으며, 텍스트도 안정적으로 렌더링될 만큼 충분히 짧습니다.
Subject: matte kraft paper coffee bag with a flat bottom, folded top with a tin tie, fine paper grain visible, a rectangular label panel on the front
Composition: product hero shot, bag standing slightly right of center on a dark walnut surface, muted warm background, three-quarter angle slightly above eye level
Light: soft window light from the left, gentle gradient across the bag face, long soft shadow falling right
Text: the words "NIGHT ROAST" in a bold condensed serif on the label panel, centered; the words "250g" in a small sans-serif beneath it
Negatives: warped lettering, duplicate text, torn paper edges, harsh specular hotspots
앞에서 보여준 것과 같은 요청 형태로 보내되, 프롬프트 문자열만 바꾸세요:
prompt = " ".join([
"Subject: matte kraft paper coffee bag with a flat bottom, folded top with a tin tie,",
"fine paper grain visible, a rectangular label panel on the front.",
"Composition: product hero shot, bag standing slightly right of center on a dark walnut surface,",
"muted warm background, three-quarter angle slightly above eye level.",
"Light: soft window light from the left, gentle gradient across the bag face, long soft shadow falling right.",
"Text: the words \"NIGHT ROAST\" in a bold condensed serif on the label panel, centered;",
"the words \"250g\" in a small sans-serif beneath it.",
"Negatives: warped lettering, duplicate text, torn paper edges, harsh specular hotspots.",
])
payload = {"model": "flux-2-klein-9b/text-to-image", "prompt": prompt}
첫 렌더링을 체크리스트처럼 읽으세요. 텍스트가 선명하게 읽히고 철자가 맞습니까? 아니라면 문구를 줄이거나 글꼴 설명을 단순화하세요. 종이 질감이 나타납니까? 가방이 플라스틱처럼 보인다면 재질 슬롯을 강화하고 표면 처리 서술어를 추가하세요. 그림자 방향이 일관됩니까? 그림자가 두 개 보인다면 조명 슬롯에 충돌이 있는 것이니 광원 하나를 제거하세요.
매 반복마다 변경은 하나만 하고, 목표 슬롯을 개선하면서 다른 슬롯을 악화시키지 않는 버전을 유지하세요. 채택된 각 프롬프트를 그 출력과 함께 저장하면 특정 SKU의 레시피를 영원히 잃지 않습니다.
반복: 첫 렌더링에서 일관된 이미지 세트까지
좋은 렌더링 한 장은 시연일 뿐입니다. 전자상거래 카탈로그에 필요한 것은 일관된 이미지 세트입니다. 목표는 주체, 조명 논리, 텍스트 처리를 고정하면서 구도를 바꾸는 것입니다.
아이덴티티 슬롯 동결하기
전체 이미지 세트에서 Subject와 Light를 바이트 단위로 동일하게 유지하세요. 이들은 제품이 무엇인지, 어떻게 조명되는지를 정의합니다. 샷마다 이것들을 바꾸는 것이 바로 한 세트의 이미지가 서로 다른 브랜드에서 온 것처럼 보이게 만드는 원인입니다. 코드에서 이들을 상수로 고정하고, 그 위에서 변형만 구성하세요.
의도적으로 구도 바꾸기
두세 가지 구도 문자열을 미리 작성해 SKU 간에 재사용하세요:
product hero shot, centered, eye-level, neutral gradient backgroundthree-quarter angle from above, product in the lower two thirds, surface visibleflat lay, directly overhead, even margins on all sides
고정된 구도 어휘를 번갈아 사용하면 무작위가 아니라 의도적으로 설계된 것처럼 보이는 이미지 세트가 나옵니다.
변형마다 텍스트 슬롯만 교체하기
한 제품 라인이 포장을 공유한다면, SKU 간에는 보통 텍스트 슬롯만 바뀝니다. 이것을 파라미터화하고 나머지는 모두 그대로 두세요. 이 슬롯이 가장 실패하기 쉬운 슬롯이므로, 전체 세트를 생성하기 전에 단일 구도로 따로 테스트하세요.
변경 사항을 diff로 추적하기
프롬프트를 버전 관리에 넣으세요. 각 커밋은 슬롯 하나만 바꾸고, 그것이 만든 렌더링을 첨부해야 합니다. 이후 변형에서 회귀가 발생하면 — 예를 들어 라벨이 갑자기 일그러진다면 — 전체 레시피를 다시 도출하지 않고 구체적인 슬롯 편집까지 추적할 수 있습니다.
튜닝을 언제 멈출지 알기
어떤 슬롯을 세 번 연속 편집해도 눈에 띄는 개선이 없다면, 문제는 프롬프트 밖에 있을 가능성이 큽니다: 요청 자체, 또는 현재 프레이밍에서 모델이 해석할 수 없는 물리적 디테일입니다. 그 디테일을 프롬프트에서 빼고 후처리하거나, 구도를 바꿔 더 이상 부담을 지지 않게 하세요.
상수와 구도 어휘가 안정되면, 전체 제품 세트 생성은 매번 프롬프트를 새로 쓰는 작업이 아니라 텍스트와 구도 문자열을 순환하는 일이 됩니다. 레시피 골격을 고정해 두면 카탈로그는 그에 따라 확장됩니다.