사용 가이드

hiapi API로 flux-2-klein-9b/text-to-image를 사용해 이커머스 제품 이미지 생성하기

Aug 14, 2026

대부분의 빠르고 저렴한 텍스트-투-이미지 모델은 선택을 강요합니다. 이미지 위의 텍스트가 선명하게 읽히도록 하거나, 가격을 낮추거나.flux-2-klein-9b/text-to-image는 '저가·고속' 등급에서 이 둘 사이에서 선택을 강요하지 않는 몇 안 되는 모델 중 하나입니다. hiapi는 이 모델에 Text Rendering, High Fidelity(텍스트 렌더링, 고충실도) 태그를 붙였는데, 실제 사용에서 이것은 한 번의 생성으로 브랜드 텍스트 로고, 작은 글씨 라벨 한 줄, 눈에 띄는 프로모션 대제목을 모두 렌더링할 수 있다는 뜻입니다—깨진 글자를 고치기 위해 두 번째 생성를 돌릴 필요가 없습니다.

이는 특히 이커머스 제품 이미지에서 중요합니다. 실제로 텍스트가 필요한 이미지—보이는 라벨이 있는 대표 이미지, 가격 표기가 있는 한정 프로모션 배너—야말로 저렴한 '고속' 모델이 가장 망치기 쉬운 부분이기 때문입니다.

이 글에서는 세 장의 이미지 모두 flux-2-klein-9b/text-to-image로 생성했으며, 재시도는 전혀 없었습니다: 라벨 텍스트, 프로모션 대제목, 할인 정보 줄이 첫 생성에서 모두 깔끔하게 나왔습니다. 모든 프롬프트에서 이것이 보장된다는 뜻은 아니지만(아래 교정 안내 참조), 이 가격대의 모델로서는 좋은 징조입니다.

가격: flux-2-klein-9b와 flux-2-klein-4b(텍스트-투-이미지) 비교

두 모델은 같은 'Klein' 패밀리에 속하며 모두 빠른 속도와 저비용을 내세웁니다. 차이는 무엇에 비용을 지불하는가입니다:

모델	이미지당 가격	태그
`flux-2-klein-9b/text-to-image`	통일 $0.00858	Text-to-Image, Text Rendering, High Fidelity
`flux-2-klein-4b/text-to-image`	통일 $0.00143	Text-to-Image, Fast, Cost Efficient

(가격은 2026-08 기준 데이터이며 /api/pricing과 대조 확인했습니다.)

flux-2-klein-4b/text-to-image는 약 6배 저렴합니다—배경 패널, 라이프스타일 장면 이미지, 또는 텍스트가 구도에 참여하지 않는 모든 이미지의 기본 선택으로 적합합니다. 하지만 텍스트 렌더링 태그가 없으므로, 카드나 라벨, 배너의 텍스트가 실제로 선명하게 읽혀야 한다면 가격이 더 높더라도 klein-9b가 더 안전한 선택입니다. 그리고 한 장에 1센트도 안 되는 가격이라면 여기서의 '안전함'은 대부분의 LLM API 호출 한 번보다도 저렴합니다.

실제 요청 예시

다음은 /v1/tasks 엔드포인트로 렌더링된 텍스트가 포함된 프로모션 카드를 생성하는 실제 요청입니다:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "이커머스 한정 프로모션용 소셜 미디어 홍보 배너: 무광 유리 스포이드 병 하나, 라벨에 'VELURA HYDRA SERUM'이라고 적혀 있음, 블러시 핑크에서 크림색으로 변하는 부드러운 그라데이션 배경 중앙에 배치, 상단에는 굵고 깔끔한 산세리프 대제목 텍스트 'FLASH SALE', 짙은 차콜 그레이 글자, 그 아래 같은 서체의 더 작은 텍스트 한 줄 '30% OFF', 오른쪽 아래에는 얇은 선의 둥근 사각형 배지 안에 'VELURA' 텍스트, 타이포그래피가 선명하게 읽히고 여백이 균형 잡힘, 현대적 미니멀 마케팅 디자인, 다른 텍스트 없음, 워터마크 없음",
      "aspect_ratio": "1:1"
    }
  }'

이 요청은 taskId를 반환합니다. GET /v1/tasks/{taskId}를 status가 success가 될 때까지 폴링한 다음 output[0].url을 다운로드하세요—서명된 링크는 만료되므로 즉시 바이트를 가져와 직접 저장해야 합니다.

스키마 주의사항: 실제로 동작하는 부분

이 모델을 기반으로 개발하기 전에 알아둘 만한 몇 가지가 있습니다. 이는 문서뿐 아니라 API가 실제로 허용하는 내용에 근거합니다:

resolution은 거부됩니다. 다른 일부 hiapi 이미지 모델과 달리 resolution 필드를 보내면 400(additional properties not allowed)이 반환됩니다. aspect_ratio만 보내세요.
aspect_ratio는 고정된 짧은 목록입니다: 1:1, 4:3, 3:4, 16:9, 9:16. 4:5나 21:9는 없습니다—레이아웃에 더 세로로 긴 크롭이 필요하다면 3:4가 가장 가까운 지원 비율입니다(아래 라이프스타일 장면 이미지에서 사용한 비율입니다).
aspect_ratio 자체는 선택 사항입니다. 완전히 생략해도 서버 기본값으로 유효한 이미지가 생성됩니다—하지만 이커머스 작업에서는 거의 항상 확정된 화면 비율(피드 게시물은 정사각형, 메인 배너는 16:9)을 원하므로 기본값에 의존하기보다 명시적으로 설정하는 것이 좋습니다.
이미지당 통일 가격, 해상도 구간 없음. flux-2-klein-4b/image-to-image(메가픽셀 기준 다섯 구간 가격)와 달리 klein-9b/text-to-image는 화면 비율에 관계없이 단일 통일 요금입니다.

프롬프트 + 출력: 대표 이미지

프롬프트(16:9, 그대로 사용, 생성 후 수정 없음):

이커머스 제품 대표 이미지: 고급 스킨케어 세럼이 든 무광 유리 스포이드 병 하나가 촉촉한 회색 대리석 판 위에 서 있음, 왼쪽에서 들어오는 부드러운 햇빛이 은은한 반사를 드리움, 미니멀한 베이지색 배경, 대리석 위의 작은 물방울들, 병 라벨에는 깔끔한 현대적 세리프 서체로 'VELURA'가 선명하게 적혀 있고 그 아래 더 작은 텍스트 'HYDRA SERUM', 전문 스튜디오 제품 사진, 선명한 초점, 은은한 림 라이트, 다른 텍스트 없음, 손 없음, 로고 워터마크 없음

(이미지는 이 글 상단에 표시되어 있습니다.) 브랜드명과 제품 라인 모두 일반적인 읽기 거리에서 깔끔하게 렌더링되었습니다—반복된 글자도, 녹아내린 세리프도 없었으며, 이는 이 가격대의 저가 텍스트-투-이미지 모델에서 흔한 실패 유형입니다.

프롬프트 + 출력: 라이프스타일 장면

프롬프트(3:4):

라이프스타일 이커머스 사진: 라벨에 'VELURA HYDRA SERUM'이라고 적힌 무광 유리 스포이드 병 하나가 밝은 욕실 세면대 위에 놓여 있음, 옆에는 접힌 흰 수건과 작은 유칼립투스 가지 화분, 창문으로 따뜻한 아침 햇살이 들어옴, 부드러운 그림자, 얕은 심도, 자연스럽고 편안한 연출, 병 라벨 텍스트 'VELURA'와 'HYDRA SERUM'은 선명하게 읽힘 유지, 사람 없음, 손 없음, 추가 텍스트 오버레이 없음

이런 라이프스타일 장면 이미지에는 보통 이미지 위 텍스트가 전혀 필요 없습니다—하지만 라벨은 스튜디오 대표 이미지보다 더 부드럽고 확산된 조명 조건에서도 견뎌야 하며, 이는 모델의 텍스트 충실도에 더 어려운 테스트입니다.

프롬프트 + 출력: 한정 프로모션 카드

프롬프트(1:1):

이커머스 한정 프로모션용 소셜 미디어 홍보 배너: 라벨에 'VELURA HYDRA SERUM'이라고 적힌 무광 유리 스포이드 병 하나가 블러시 핑크에서 크림색으로 변하는 부드러운 그라데이션 배경 중앙에 배치, 상단에는 굵고 깔끔한 산세리프 대제목 텍스트 'FLASH SALE', 짙은 차콜 그레이 글자, 그 아래 같은 서체의 더 작은 텍스트 한 줄 '30% OFF', 오른쪽 아래에는 얇은 선의 둥근 사각형 배지 안에 'VELURA' 텍스트, 타이포그래피가 선명하게 읽히고 여백이 균형 잡힘, 현대적 미니멀 마케팅 디자인, 다른 텍스트 없음, 워터마크 없음

이 이미지가 모델의 'Text Rendering, High Fidelity' 태그를 진정으로 시험하는 부분입니다: 두 줄의 대제목 텍스트와 작은 배지 텍스트가 모두 한 번의 생성으로 완성됩니다. 모든 단어가 올바르게 철자되었고 자간도 적절하게 유지되었습니다—하지만 바로 그렇기 때문에 게시 전에 직접 눈으로 확인해야 합니다(아래 참조).

교정은 건너뛰지 마세요

hiapi 자체 콘텐츠 가이드라인은 이를 분명히 밝힙니다: AI 텍스트 렌더링은 '99%이지 100%가 아닙니다'. 고충실도 텍스트 태그가 붙은 모델조차 가끔 단어를 잘못 쓰거나 글자를 빠뜨리거나 두 단어를 붙여버릴 수 있습니다—특히 작은 라벨 텍스트가 대제목 텍스트보다 더 그렇습니다(작은 글씨가 더 어렵습니다). 생성된 프로모션 카드나 제품 라벨을 게시하기 전에:

모든 렌더링된 텍스트 줄을 100% 배율로 확대해서 보세요.
철자와 간격을 확인하세요. '텍스트처럼 보이는지'만 보지 마세요.
뭔가 잘못되었다면 다시 생성하세요—픽셀을 수동으로 고치지 마세요. 재실행은 몇 푼의 일부에 불과합니다.
자주 바뀌는 텍스트(가격, 프로모션 날짜)는 매번 생성에 구워 넣지 말고, 직접 만든 템플릿 단계에서 오버레이하는 것을 고려하세요—업데이트가 더 저렴하고 재실행 위험도 완전히 사라집니다.

Python으로 일괄 생성하기

전체 제품 카탈로그를 위해 같은 요청 패턴을 반복문으로 감싸세요:

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(
            f"{BASE}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # download immediately — the URL expires

이미지당 $0.00858로 계산하면, 50개 SKU에 각 SKU당 3장(대표 이미지, 라이프스타일, 프로모션)인 제품 카탈로그는 총 약 $1.29입니다—프리랜서 제품 사진 촬영과 비교하면 사실상 푼돈입니다.

flux-2-klein-9b/text-to-image와 관련 워크플로 비교

hiapi에서 더 완전한 제품 이미지 파이프라인을 구축하고 있다면, 다음 관련 부분을 읽어볼 만합니다:

기존 제품 사진을 처음부터 생성하는 대신 편집하거나 스타일을 바꿔야 한다면 이미지-투-이미지 이커머스 보정에 flux-2-klein-4b 사용하기를 참고하세요—이는 다른 작업(i2i, t2i가 아님)으로 새 장면을 생성하는 대신 실제 사진을 다듬기 위해 구축되었습니다.
9b 등급 이미지-투-이미지 모드 특유의 프롬프트 패턴(동일한 텍스트 렌더링 강도, 편집에 적용)은 flux-2-klein-9b 이미지-투-이미지 프롬프트를 참고하세요.
전체 매개변수, 실시간 가격, 그리고 대량 실행 전에 프롬프트를 테스트할 수 있는 콘솔: flux-2-klein-9b/text-to-image 모델 페이지.

FAQ

flux-2-klein-9b/text-to-image는 이미지-투-이미지를 지원하나요? 아니요—이 특정 엔드포인트는 텍스트-투-이미지만 지원합니다. hiapi는 기존 사진 편집용으로 별도의 flux-2-klein-9b/image-to-image 모델(가격 $0.03143/이미지)을 제공합니다.

어떤 화면 비율이 지원되나요? 다섯 가지: 1:1, 4:3, 3:4, 16:9, 9:16. 네이티브 4:5는 없습니다—3:4로 비슷한 세로 크롭을 얻으세요.

출력 해상도를 설정할 수 있나요? 아니요. resolution 필드를 보내면 400이 반환됩니다. 가격과 출력 크기는 화면 비율에 따라 고정됩니다.

flux-2-klein-4b로 바꾸면 더 저렴한가요? 네, 이미지당 약 6배 저렴합니다($0.00143 대 $0.00858)—하지만 klein-4b에는 텍스트 렌더링 태그가 없습니다. 텍스트가 없는 이미지(순수 라이프스타일 장면이나 배경 이미지)에는 이쪽을 쓰고, 라벨, 제목, 가격 표기가 있는 모든 이미지에는 klein-9b를 남겨두세요.

생성에 얼마나 걸리나요? 이 글의 세 이미지 모두 /v1/tasks 폴링 흐름으로 각각 2분 이내에 완료되었습니다.

직접 시도해보기

모델 페이지에서 직접 프롬프트로 flux-2-klein-9b/text-to-image를 테스트한 뒤 배치 작업에 연결할 수 있으며, 가격 페이지에서 언제든 최신 요율을 확인할 수 있습니다. 전체 요청/응답 스키마와 인증 설정은 API 문서를 참고하세요.

핵심 요점

이미지에 선명하게 읽혀야 할 텍스트(라벨, 제목, 가격 표기)가 필요하면 flux-2-klein-9b/text-to-image를 사용하세요. 텍스트가 없는 이미지에는 flux-2-klein-4b/text-to-image로 약 6배 비용을 절약하세요.
aspect_ratio는 1:1, 4:3, 3:4, 16:9, 9:16만 허용합니다—4:5는 없으며, 3:4로 비슷한 세로 크롭을 얻으세요.
절대로 resolution을 보내지 마세요—이 모델은 항상 400으로 거부합니다. aspect_ratio만으로 출력 크기가 결정됩니다.
High Fidelity 텍스트 태그가 있더라도 게시 전에 렌더링된 모든 단어를 교정하세요—작은 라벨 텍스트가 큰 제목보다 더 어렵습니다.
50개 SKU에 각 3장인 제품 카탈로그는 $0.00858/이미지 기준 총 약 $1.29입니다.