Recraft V4.1 Flash 전자상거래 제품 이미지: 장당 $0.01 대량 카탈로그 이미지

TL;DR

• HiAPI에서 recraft-v4.1-flash/text-to-image는 장당 $0.01에 불과하므로 1,000장의 카탈로그 이미지 비용은 $10.00입니다. 표준 버전 recraft-v4.1/text-to-image는 장당 $0.05이며 동일한 파라미터를 받습니다(가격 비교).
• 당사의 실행에서 병렬로 제출한 4장의 제품 이미지가 실제 소요 시간 21.5초 내에 완료되었으며, 작업당(다운로드 포함) 약 19–20초였습니다. 총 비용: $0.04.
• background_color를 흰색으로 설정하면 생성된 배경이 흰색에 가깝지만 #FFFFFF로 균일하지는 않습니다. 마켓플레이스가 순수 흰색을 요구한다면 추가 정리 단계를 더해야 합니다.

카탈로그에 Flash 등급을 선택해야 할 때

작업량이 많을 때 Flash를 사용하세요: 모든 SKU에 흰색 배경 상품 목록 이미지가 필요하고, 여기에 장면 이미지 한두 장을 더하며, 게시 전에 하나씩 검토할 계획이라면 적합합니다. 장당 $0.01로 계산하면 500개 SKU에 각 3장씩 총 $15.00입니다. 같은 1,500장을 표준 버전 V4.1로 만들면 $75.00가 필요합니다.

Flash와 표준 버전 V4.1은 동일한 입력 필드를 받으므로, 선별된 이미지를 더 높은 등급으로 업그레이드하려면 model만 변경하면 됩니다. 이 글은 두 등급의 이미지 품질을 비교하지 않습니다. 일치하는 프롬프트로 둘을 각각 실행해 보지 않았기 때문입니다. 공식 소재에 사용할 등급을 최종 결정하기 전에 직접 출력 결과를 확인하세요.

검증된 입력 schema

의도적으로 유효하지 않은 값을 보내 실시간 API와 대조하여 schema를 확인했습니다:

필드	타입	비고
prompt	string(문자열)	필수
image_size	enum(열거형)	square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
colors	{r,g,b} 배열	팔레트 유도. 문자열을 전달하면 400 INVALID_REQUEST: colors: got string, want array가 반환됩니다
background_color	{r,g,b}	배경 색상

알 수 없는 필드는 거부되며(additional properties ... not allowed), 여섯 가지 프리셋 외의 image_size도 거부됩니다. 사용자 지정 픽셀 크기는 지원되지 않습니다. 확인한 크기: square_hd 1024×1024, portrait_4_3 896×1216, landscape_4_3 1216×896.

한 배치의 실제 출력

아래 네 장의 이미지는 모두 동일한 병렬 배치에서 나왔습니다. 캡션에 크기를 표기했으며, 장당 비용은 $0.01입니다.

흰색 배경 상품 목록 이미지

E-commerce product photo of a matte sage-green ceramic coffee mug with a curved handle, centered, front three-quarter view, pure white seamless background, soft even studio lighting, gentle contact shadow, no props, no text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color 흰색, $0.01.

E-commerce product photo of a single white leather low-top sneaker with gum rubber sole, side profile facing left, pure white seamless background, soft even studio lighting, subtle shadow under the sole, no props, no text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color 흰색, $0.01.

머그컵은 프롬프트와 매우 잘 맞았습니다: 중앙 배치, 깔끔한 접촉 그림자, 소품 없음. 스니커는 왜 여전히 검토가 필요한지 보여줍니다. 요청한 것은 생고무 밑창(gum rubber sole)이었지만 크림색 밑창이 나왔고, 신발이 중앙이 아니라 화면 아래쪽에 놓였습니다. 실제 제품과 대조하지 않으면 두 이미지 모두 실제 SKU의 사용 가능한 상품 목록 이미지로 쓸 수 없습니다.

라이프스타일 장면 이미지

Lifestyle product photo of an amber glass dropper serum bottle with a plain white label, standing on a travertine stone tray beside a eucalyptus sprig, bathroom shelf, soft morning window light, shallow depth of field, premium skincare catalog look

recraft-v4.1-flash/text-to-image, portrait_4_3, 896×1216, $0.01.

Lifestyle product photo of a charcoal canvas rolltop backpack leaning against a wooden bench in a sunlit train station, warm afternoon light, shallow depth of field, travel catalog look, no people, no logos

recraft-v4.1-flash/text-to-image, landscape_4_3, 1216×896, $0.01.

두 장면 모두 각자의 프롬프트에 담긴 소품과 조명 힌트를 모두 반영했습니다. 세럼 병 라벨은 요청대로 비어 있습니다. 나중에 실제 라벨을 합성할 계획이라면 유용하며, 모델이 임의의 텍스트를 지어내게 하는 것보다 안전합니다.

"흰색 배경"이 실제로 반환하는 것

두 상품 목록 이미지에서 픽셀을 샘플링했습니다:

이미지	모서리 / 가장자리 샘플 (RGB)	정확히 255,255,255	흰색에 가까움(모든 채널 ≥ 250)
머그컵	255,255,255 · 255,255,253 · 253,254,252	픽셀의 48.1%	75.4%
스니커	254,253,253 · 251,250,249 · 255,255,255	픽셀의 58.3%	79.3%

배경은 흰색으로 보이지만 완전히 평평한 #FFFFFF는 아닙니다. 대표 이미지에 순수 흰색을 요구하는 마켓플레이스는 후처리 단계가 필요합니다. 흰색에 가까운 픽셀을 255로 클램프하거나, 제품을 오려내어 깨끗한 캔버스에 배치할 수 있습니다. Recraft 배경 제거 튜토리얼에서 동일한 API를 활용한 누끼 방식을 소개합니다.

배치 스크립트: 병렬 제출, 폴링, 다운로드

당사가 실행한 스크립트이며 간추렸습니다. 각 SKU에는 자체 Idempotency-Key가 있어 네트워크 타임아웃 후 재시도해도 중복 과금 작업이 생성되지 않습니다. 출력 URL은 임시입니다. 당사의 URL은 temp.hiapi.ai에 있으며 expireAt이 있어 생성 후 정확히 7일 뒤 만료됩니다. 작업이 성공하면 각 이미지를 최대한 빨리 다운로드해야 합니다.

import os, time, requests
from concurrent.futures import ThreadPoolExecutor

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}",
           "Content-Type": "application/json"}
WHITE = {"r": 255, "g": 255, "b": 255}
BATCH_ID = "catalog-2026-11-01"  # change per intentional new batch

JOBS = [
    {"sku": "mug-sage", "image_size": "square_hd", "background_color": WHITE,
     "prompt": "E-commerce product photo of a matte sage-green ceramic coffee mug ..."},
    {"sku": "serum-amber", "image_size": "portrait_4_3",
     "prompt": "Lifestyle product photo of an amber glass dropper serum bottle ..."},
    # one dict per SKU / shot
]

def run(job):
    payload = {"model": "recraft-v4.1-flash/text-to-image",
               "input": {k: v for k, v in job.items() if k != "sku"}}
    r = requests.post(BASE, json=payload, timeout=60,
                      headers={**HEADERS, "Idempotency-Key": f"{BATCH_ID}-{job['sku']}"})
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    while True:
        task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] in ("success", "fail", "failed"):
            break
        time.sleep(3)
    if task["status"] != "success":
        return job["sku"], task["status"]
    img = requests.get(task["output"][0]["url"], timeout=60).content
    with open(f"{job['sku']}.webp", "wb") as f:  # output was WebP in our run
        f.write(img)
    return job["sku"], "saved"

with ThreadPoolExecutor(max_workers=4) as pool:
    for sku, status in pool.map(run, JOBS):
        print(sku, status)

당사의 실행은 작업마다 다음과 같은 내용을 반환했습니다(하나만 표시):

{
  "taskId": "tk-hiapi-01M6AMTSX0B7Z531QT740DS54P",
  "model": "recraft-v4.1-flash/text-to-image",
  "status": "success",
  "storage": "temp",
  "output": [{"type": "image", "url": "https://temp.hiapi.ai/.../...-0.webp", "expireAt": 1794111048}]
}

해당 작업의 created와 completed 타임스탬프 차이는 9초였습니다. 클라이언트 측의 나머지 시간은 폴링 간격과 0.45–1.26 MB의 WebP 파일 다운로드에 쓰였습니다. 전체 요청 및 폴링 세부 사항은 Recraft V4.1 API 가이드와 HiAPI 문서를 참고하세요.

카탈로그 예산

SKU당 이미지 수	SKU 100개	SKU 1,000개
1(상품 목록 이미지만)	$1.00	$10.00
3(상품 목록 이미지 + 장면 이미지 2장)	$3.00	$30.00
3 + 2회 재생성	$5.00	$50.00

Flash 장당 $0.01, 2026년 11월 1일 HiAPI 가격 기준. 재생성도 다른 이미지와 동일하게 과금되므로 예산의 일부를 여유분으로 두세요.

상품 목록 이미지에 적합한 프롬프트 패턴

• 촬영 유형으로 시작하고(E-commerce product photo of ...), 이어서 소재 + 색상 + 제품을 씁니다.
• 카메라 각도를 고정합니다(front three-quarter view, side profile facing left).
• 배경과 조명을 명시하고(pure white seamless background, soft even studio lighting), 동시에 background_color도 전달합니다.
• 제외 항목으로 끝냅니다: no props, no text.
• 제품 특유의 세부 사항은 실제 물건과 대조해 확인하세요. 스니커의 밑창 색은 모델이 이런 세부 사항에서 어긋날 수 있음을 보여줍니다.

자주 묻는 질문

Flash는 대표 상품 목록 이미지에 충분한가요? 머그컵처럼 단순한 제품은 출력이 깔끔합니다. 하지만 세부 사항이 어긋날 수 있고(스니커 밑창처럼) 배경이 순수 #FFFFFF가 아닙니다. 각 이미지를 검토하고, 마켓플레이스가 요구한다면 배경도 정리하세요.

한 배치에서 브랜드 색상을 일관되게 유지할 수 있나요? 가능합니다. 각 요청에 동일한 colors 배열을 전달하세요. 팔레트를 유도하지만 픽셀 단위로 정확한 색상 고정은 아닙니다.

선별된 이미지를 표준 버전 V4.1로 업그레이드하려면 어떻게 하나요? 동일한 페이로드로 다시 보내되 model을 recraft-v4.1/text-to-image로 설정하면 장당 $0.05입니다.

이것이 실제 제품을 생성하나요? 아니요. 텍스트→이미지는 설명에 맞는 제품을 만들어냅니다. 실제 물건을 보여주려면 생성된 장면을 배경이나 목업으로 사용하거나 이미지→이미지 워크플로로 전환하세요.

카탈로그 초안을 작성할 준비가 되셨나요? Recraft V4.1 Flash 모델 페이지를 열어 상품 목록 프롬프트 하나를 먼저 시험해 보고, 나머지 SKU에는 배치 스크립트를 실행하세요.