사용 가이드
이커머스 제품 이미지를 위한 Flux-2 텍스트-투-이미지: 프롬프트 레시피와 사용 가능한 HiAPI 요청
앵글, 조명, 정밀 디테일을 위한 프롬프트 템플릿과 복사-붙여넣기 가능한 HiAPI 요청 및 배치 패턴
이 페이지에서
flux-2/text-to-image가 이커머스 상품 카탈로그에 적합한 이유
제품 이미지 제작에는 비용 곡선 문제가 있습니다. 모든 SKU에 여러 앵글, 일관된 조명, 깔끔한 배경이 필요하지만, '변형을 하나 더 만드는' 한계 비용은 촬영이든 보정이든 매우 높습니다. 탄탄한 제품 설명과 반복 가능한 프롬프트가 있다면 텍스트-투-이미지는 이 셈법을 바꿔놓습니다.
텍스트-투-이미지가 유리한 상황
- 롱테일 및 변형 SKU. 별도 촬영이 아깝던 색상, 사이즈, 구성도 카탈로그에 바로 넣을 수 있는 이미지를 얻을 수 있습니다.
- 컨셉 이미지와 플레이스홀더. 카테고리 페이지, A/B 테스트, 출시 전 상품 목록에는 실물 샘플이 도착하기 전에도 신뢰감 있는 이미지가 필요합니다.
- 스타일 탐색. 정식 촬영을 예약하기 전에 배경과 조명 방향을 빠르게 테스트하여 비주얼 방향을 먼저 확정할 수 있습니다.
사진 촬영으로 대체할 수 없는 상황
구매자의 결정이 실물 디테일에 달려 있다면—스티치, 마모, 인증 라벨, 실제 조명 아래의 정확한 색상—생성된 이미지는 증거가 아니라 컨셉일 뿐입니다. flux-2/text-to-image 출력을 상품 카탈로그 소재로 쓸 수 있는 것은 이미지가 실제 발송 제품을 대표할 때뿐입니다. 정확성을 내세우는 메인 이미지에는 실제 사진을 유지하세요.
이미지-투-이미지와 비교하면 텍스트-투-이미지는 프롬프트 요구 수준이 더 높습니다. 구도를 고정해 줄 참조 이미지가 없기 때문입니다. 이것이 트레이드오프입니다. 앵글, 조명, 배경을 완전히 제어하는 대신 그것들을 명시적으로 서술해야 합니다. 이 가이드의 나머지 부분은 그 서술을 반복 가능하게 만드는 방법에 관한 것입니다.

SKU 전반에 안정적으로 재사용할 수 있는 기본 프롬프트 구조
한 제품에는 효과가 있지만 다른 제품에서는 실패하는 프롬프트는 대개 제품 특유의 사실과 장면 결정을 뒤섞기 때문입니다. 둘을 분리하세요.
6슬롯 골격
[주체] — [앵글] — [조명] — [배경] — [디테일] — [스타일/제약]
- 주체: 물체가 무엇인지, 재질, 색상, 그리고 형태를 정의하는 특징. 사실적으로 유지하세요.
- 앵글: 제품 대비 카메라 위치(정면 3/4, 탑뷰, 아이레벨).
- 조명: 소프트박스 키 라이트, 림 라이트, 그림자 부드러움, 방향.
- 배경: 표면, 색상, 초점 여부.
- 디테일: 구매자가 확인할 두세 가지 특징.
- 스타일/제약: 상업 제품 사진, 선명한 초점, 텍스트 없음, 중앙 구도.
채워 넣은 예시
짙은 포레스트 그린의 무광 세라믹 커피 머그, 정면 3/4 앵글, 아이레벨 높이,
왼쪽 위에서 부드럽게 확산되는 키 라이트, 오른쪽 가장자리에 은은한 림 라이트, 이음새 없는 밝은 회색 배경,
무광 유약 질감과 깔끔한 손잡이 곡선이 보임, 상업 제품 사진, 선명한 초점,
텍스트 없음, 로고 없음, 중앙 구도
슬롯은 고정하고 사실만 교체
골격을 생성 스크립트에 한 번 저장하고, SKU마다 주체와 디테일 슬롯만 주입하세요. 앵글, 조명, 배경, 스타일은 한 배치 내내 고정합니다—이것이 한 세트의 이미지가 콜라주가 아니라 같은 카탈로그처럼 보이게 하는 이유입니다. 두 번째 시점(탑뷰, 측면)이 필요하면 슬롯 하나만 바꾸세요. 그러면 모든 시각적 차이를 그 한 가지 변경에 귀속시킬 수 있습니다.
실용적인 습관 하나: 작성하는 모든 프롬프트에서 동일한 슬롯 순서를 유지하세요. 모델도 구조를 따르고, 6개월 뒤 프롬프트 라이브러리를 검토하는 사람도 마찬가지입니다.
카메라 앵글과 조명을 위한 프롬프트 레시피
이 템플릿들은 [주체] 슬롯 뒤에 붙여 넣도록 설계되었습니다. 브랜드 배경색에 맞게 배경 색상을 교체하세요.
앵글 레시피
정면 3/4(기본 메인 이미지 앵글)
정면 3/4 시점, 카메라는 제품 중간 높이에 위치, 제품이 중앙에 있음,
제품 전체가 보임, 사방에 약간의 여백
아이레벨 / 정면
정면 아이레벨 시점, 카메라가 제품 정면과 평행,
원근 왜곡 없음, 제품이 중앙에 있음
탑뷰 플랫레이
탑다운 오버헤드 시점, 카메라가 표면에 수직,
제품이 중앙에 있고 여백이 균일함, 아래에 평평한 그림자
약간의 하이 앵글(박스형 제품에 적합)
제품 위 30도 시점에서 바라봄, 정면과 윗면이 모두 보임,
카메라가 제품 중심을 향해 기울어짐
조명 레시피
부드러운 스튜디오 조명(안전한 기본값)
왼쪽 위 대형 소프트박스 키 라이트, 오른쪽 흰색 반사판 필 라이트,
제품 아래 부드러운 접촉 그림자, 강한 하이라이트 없음
질감을 강조하는 측광
왼쪽 측면에서 스치는 조명으로 표면 질감 강조, 정면에 부드러운 필 라이트,
그림자가 오른쪽으로 드리움, 배경은 균일하게 조명됨
깔끔한 카탈로그 화이트
45도 각도의 부드러운 광원 두 개로 밝고 균일한 조명, 그림자 최소,
이음새 없는 흰색 배경, 제품 윤곽이 선명하게 분리됨
분위기 있는 포인트(라이프스타일 느낌)
오른쪽 위 단일 방향성 키 라이트, 짙은 회색 배경으로 깊게 감쇠,
한쪽 가장자리에 부드러운 하이라이트, 통제된 그림자
공통 구도 포인트
- 원근이 중요할 때는 카메라 높이를 명시하세요. '중간 높이'와 '탑뷰'는 전혀 다른 실루엣을 만듭니다.
- 그림자가 어디로 드리우는지 명시하세요. 그림자를 지정하지 않는 것은 배치 불일치의 가장 흔한 원인입니다.
- 여백 표현을 고정하세요('사방에 약간의 여백'). 그러면 배치 전체에서 제품이 다르게 잘리지 않습니다.
앵글 레시피 하나와 조명 레시피 하나를 결합하면 안정적인 매트릭스가 됩니다. 네 가지 앵글에 네 가지 조명 세팅을 곱하면 하나의 골격에서 열여섯 가지 외형이 나옵니다.

프롬프트 준수도와 고충실도 디테일을 높이는 표현
준수 문제는 대개 형용사가 부족해서가 아니라 모호한 명사에서 비롯됩니다. '아름답고, 고급스럽고, 놀라운'을 쌓아 올리는 것은 모델에게 무엇을 렌더링할지 알려주지 않고 스타일 노이즈만 더합니다.
재질을 정확히 명명하기
'좋은 원단'을 실제 표면으로 바꾸세요: 브러시드 알루미늄, 무광 분체 도장 강철, 페이크 레더, 프로스트 글라스, 표백하지 않은 코튼 캔버스. 재질 단어는 질감과 반사율을 담고 있으므로 어떤 스타일 형용사보다 유용합니다.
중요한 것을 제약하기
모델은 암시된 바람보다 명시적 제한을 더 잘 따릅니다. 제약을 이미지에 대한 진술로 작성하세요:
제품이 화면 너비의 약 70%를 차지함
로고 영역은 비어 있고 표시 없음
라벨 텍스트는 글자 없이 빈 영역으로 렌더링됨
화면에 제품 하나만, 소품 없음
각 줄이 자유도를 하나씩 제거합니다. 제약은 짧고 문자 그대로 유지하세요—긴 금지 문구는 종종 뭉개집니다.
디테일을 칭찬하지 말고 가리키기
- 약함:
극도로 정교하고 고품질 - 강함:
윗변에 보이는 스티치, 가죽 표면의 미세한 질감, 브러시드 마감의 금속 버클
고충실도 디테일은 구매자가 확대해서 볼 두세 가지 특징을 명명하고 나머지는 렌더러에게 맡길 때 나옵니다. 어떤 디테일이 중요하다면 그것의 중요성이 아니라 위치와 재질을 설명하세요.
장면 단어를 제어해 드리프트 제어하기
스타일 단어는 공짜가 아닙니다. 드라마틱, 시네마틱, 럭셔리는 모두 조명과 대비를 바꿉니다. 카탈로그가 깔끔하고 중립적이라면 그것들을 빼거나 깔끔한 상업 조명, 드라마틱한 그림자 없음 같은 명시적 보정과 함께 쓰세요. 모든 스타일 지시에 대응하는 물리적 설명이 있을 때 준수도가 올라갑니다.
한 가지 더 들일 만한 습관: 제품 카테고리별로 어떤 제약 줄을 추가했는지 기록하세요. 출력이 드리프트할 때 추측 대신 프롬프트 차이를 비교할 수 있습니다.
흔한 제품 이미지 실패를 막는 네거티브 프롬프트 목록
네거티브 프롬프트는 양동이가 아니라 메스입니다. 실제로 관찰한 실패 패턴에 맞춘 짧은 목록이 유효한 렌더링을 억제할 수 있는 범용 제외 벽보다 낫습니다.
간결한 시작 목록
텍스트, 워터마크, 로고, 여분의 팔다리, 중복 제품, 어수선한 배경,
눈부신 반사 하이라이트 클리핑, 모션 블러, 기하학적 왜곡, 잘린 제품 가장자리
각 항목을 유지할 가치가 있는 이유
- 텍스트, 워터마크, 로고 — 생성된 글자는 거의 쓸 수 없고 종종 깨집니다. 틀린 것보다 빈 것이 낫습니다.
- 중복 제품 — 배경 슬롯이 모호하면 다중 객체 장면이 끼어듭니다.
- 어수선한 배경 — 깔끔한 카탈로그 외형을 보호합니다.
- 눈부신 반사 하이라이트 클리핑 — 광택 제품은 하이라이트가 잘리면 표면 디테일을 잃습니다.
- 기하학적 왜곡 — 앵글 슬롯 설명이 부족하면 손잡이, 주둥이, 가장자리가 휩니다.
- 잘린 제품 가장자리 — 여백 표현과 함께 작동하여 전체 윤곽이 화면 안에 유지되게 합니다.
카테고리별로 구분하기
쌓지 말고 추가하세요. 유리 제품에는 이중 반사, 불투명 유리가 적합합니다. 의류에는 마네킹, 실제 모델, 개켜진 옷이 적합합니다. 식품류 제품에는 결로, 장식 가니시, 소품이 적합합니다. 특정 카테고리가 안정되면 해당 항목을 제거하세요. 더 짧은 네거티브 목록이 포지티브 프롬프트를 주도하게 합니다.
경험 법칙
특정 출력에서 본 실패를 지적할 수 없다면 네거티브 목록에 추가하지 마세요. 목록은 예상이 아니라 리뷰에서 자라게 하세요.
실행 가능한 flux-2/text-to-image HiAPI 요청
아래 요청은 HiAPI 통합 인터페이스를 통해 flux-2/text-to-image에 프롬프트 하나를 보냅니다. 프롬프트 문자열을 교체하면 첫 제품 이미지가 완성됩니다.
요청
curl -X POST "https://api.hiapi.ai/v1/images/generations" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/text-to-image",
"prompt": "짙은 포레스트 그린의 무광 세라믹 커피 머그, 정면 3/4 시점, 카메라는 제품 중간 높이에 위치, 제품이 중앙에 있고 사방에 약간의 여백, 왼쪽 위 대형 소프트박스 키 라이트, 오른쪽 흰색 반사판 필 라이트, 제품 아래 부드러운 접촉 그림자, 이음새 없는 밝은 회색 배경, 무광 유약 질감과 깔끔한 손잡이 곡선이 보임, 상업 제품 사진, 선명한 초점, 텍스트 없음, 로고 없음",
"negative_prompt": "텍스트, 워터마크, 로고, 중복 제품, 어수선한 배경, 눈부신 반사 하이라이트 클리핑, 기하학적 왜곡, 잘린 제품 가장자리",
"aspect_ratio": "1:1",
"n": 1
}'
필드별 설명
- model — 호출이 flux-2 텍스트-투-이미지로 라우팅되도록 유지합니다. 명시적으로 고정하면 향후 기본값 변화가 카탈로그 외형을 조용히 바꾸지 않습니다.
- prompt — 앞서 소개한 6슬롯 골격을 앵글 하나와 조명 레시피 하나로 조립한 것입니다.
- negative_prompt — 간결한 제외 목록. 출력을 검토하면서 카테고리에 맞게 조정하세요.
- aspect_ratio — 채널별로 고정하세요(그리드 타일은 정사각형, 모바일 목록 카드는 세로형). 그러면 한 배치가 통일됩니다.
- n — 프롬프트 최적화 중에는 1로 유지하고, 선택할 변형이 필요할 때 올리세요.
응답 읽기
API는 생성된 이미지 데이터와 요청 메타데이터를 담은 JSON 객체를 반환합니다. 이미지 페이로드를 파싱하여 저장소에 쓰고, 키 이름에 SKU와 앵글/조명 조합을 포함하세요(예: mug-green__front34__soft-studio). 그리고 파일 옆에 정확한 프롬프트를 기록하세요. 이 '파일명+프롬프트' 짝이 있으면 이후 QA와 재생성이 실행 가능해집니다. 과금은 플랫폼 표준 이미지 생성 계량을 따르므로, 가정을 스크립트에 하드코딩하지 말고 계정의 가격 패널에서 현재 요율을 확인하세요.
SKU 목록 전반에 프롬프트 배치 생성
단일 요청이 작동하면 배치는 템플릿 주입에 루프를 더한 것입니다. 골격은 코드에, 제품 사실은 데이터에 두세요.
패턴
ANGLES = {
"front34": "정면 3/4 시점, 카메라는 제품 중간 높이에 위치, 제품이 중앙에 있고 사방에 약간의 여백",
"flat": "탑다운 오버헤드 시점, 카메라가 표면에 수직, 제품이 중앙에 있고 여백이 균일함, 아래에 평평한 그림자",
}
LIGHTING = "왼쪽 위 대형 소프트박스 키 라이트, 오른쪽 흰색 반사판 필 라이트, 제품 아래 부드러운 접촉 그림자"
STYLE = "상업 제품 사진, 선명한 초점, 텍스트 없음, 로고 없음, 중앙 구도"
def build_prompt(sku, angle_key):
return f"{sku['subject']}, {ANGLES[angle_key]}, {LIGHTING}, {sku['background']}, {sku['detail']}, {STYLE}"
각 SKU에 대해 필요한 앵글 키를 순회하고, 프롬프트를 구성하고, API를 호출하고, 결과를 결정적 파일 이름으로 저장하세요. 호출 사이에 짧게 쉬고 일시적 실패는 백오프 재시도하세요. 카탈로그 배치 실행은 지연에 민감하지 않으므로 속도보다 안정성이 낫습니다.
규모를 키우기 전에 확인할 것
- 프롬프트 조립이 결정적인가. 같은 SKU와 앵글은 항상 같은 프롬프트 문자열을 만들어야 합니다. 증명이 필요하면 각 프롬프트의 해시를 기록하세요.
- 고정 슬롯 값이 실제로 고정인가. 배경, 조명, 스타일은 항목별 데이터에 섞인 것이 아니라 상수에서 와야 합니다.
- 가로세로 비율이 호출 지점이 아니라 채널별로 설정되는가. 설정 한 곳에서, 루프에 흩어지지 않게.
- 저장 키에 앵글과 조명이 포함되는가. 나중에 개별 셀을 재생성할 것이므로 주소 지정이 가능해야 합니다.
- 먼저 소규모 파일럿을 실행하세요. 모든 앵글을 아우르는 SKU 10개로 전체 목록 처리 전에 검토하세요.
비용과 시간 예상
생성 시간은 프롬프트 수가 아니라 이미지 수에 비례해 늘어나므로 이미지 한 장당 호출 한 번으로 예산을 잡고 그에 맞춰 배치를 계획하세요. 배치 실행 중에는 n을 1로 유지하고, 검토를 통과하지 못한 SKU에만 변형을 생성하세요—같은 프롬프트에 더 높은 n을 쓰는 것이 전혀 필요 없는 두 번째 앵글보다 추론하기 쉽습니다.
카탈로그에 넣기 전 출력 검토
좋아 보이지만 제품을 잘못 표현한 생성 이미지는 이미지가 없는 것보다 나쁩니다. 모든 출력을 게시하기 전에 짧고 일관된 QA 점검을 실행하세요.
체크리스트
- 앵글이 라벨과 일치하는가.
front34라는 파일은 실제로 정면 3/4 시점이어야 합니다. 각 이미지가 개별적으로 좋아 보여도 앵글 불일치는 그리드 일관성을 깨뜨립니다. - 제품 전체가 화면 안에 있는가. 잘린 가장자리 없음, 제품이 화면 경계에 닿지 않음.
- 텍스트가 없는가. 어떤 글자, 워터마크, 로고 아티팩트든 있으면 재생성하거나 대체해야 합니다.
- 브랜드 적합성. 배경 색상, 그림자 부드러움, 대비가 기존 카탈로그와 나란히 어울려야 하며 튀지 않아야 합니다.
- 대표성. 표시된 제품이 실제 발송 제품과 일치해야 합니다: 올바른 색상, 올바른 재질, 올바른 비율.
재생성인가 대체인가
실패가 외관상이고 프롬프트로 고칠 수 있을 때(그림자 방향 오류, 배경 드리프트, 여분 소품)는 재생성하세요. 문제 슬롯을 좁히고 다시 실행하세요. 실패가 사실적일 때—모델이 특징을 지어냈거나, 재질이 잘못된 마감으로 보이거나, 제품 형태가 충실하지 않을 때—사진 촬영, 이미지-투-이미지 또는 플레이스홀더로 대체하세요. 어떤 프롬프트 수정도 실물과 맞지 않는 문제를 안정적으로 고치지 못합니다.
검토를 저비용으로 유지하기
한 번에 이미지 하나씩 보지 말고 SKU별로 모든 앵글을 모은 콘택트 시트를 검토하세요. 따로 볼 때 보이지 않는 차이—그림자 뒤집힘, 배경 이동—가 나란히 두면 뚜렷해집니다. 각 거부마다 프롬프트 해시를 기록하면 반복되는 문제가 일회성 노이즈가 아니라 프롬프트 문제로 드러납니다. 한 배치에 이렇게 하면 대부분의 실패가 소수의 반복되는 슬롯 값에 집중되어 있음을 알게 되고, 그것이 한 번에 고칠 가치가 있는 부분입니다.