hiapi를 통해 seedream-5.0-lite/image-to-image로 이커머스 상품 이미지 생성하기

온라인 스토어의 제품 사진은 단순히 예쁜 이미지 한 장을 생성하는 일이 아닙니다. 동일한 제품을 반복해서 생성해야 합니다: 흰 배경 상품 목록 이미지, 라이프스타일 장면 이미지, 공급업체 변경 후 하드웨어나 라벨을 수정한 이미지, 그리고 제품 페이지용 다섯 가지 컬러웨이 시리즈 이미지입니다. 텍스트-투-이미지 모델은 여기서 성능이 좋지 않은데, 새로운 프롬프트마다 조금씩 다른 제품을 만들어내기 때문입니다.

바로 이 지점에서 seedream-5.0-lite/image-to-image가 활용됩니다. 이는 바이트댄스의 명령 기반 이미지 편집기로, 실제 제품 사진(또는 최대 14장의 참조 이미지)을 제공하고 편집 내용을 자연어로 설명하면, 편집되지 않은 영역의 일관성을 유지하면서 명령을 따릅니다. hiapi에서는 2K 해상도 기준 이미지당 $0.035에 불과하며, 6장짜리 상품 목록 이미지 세트 전체도 약 $0.21입니다.

아래의 모든 내용은 hiapi의 실제 API 호출을 통해 생성되었습니다. 각 섹션에서는 실제 출력과 정확한 프롬프트를 보여줍니다.

워크플로: 하나의 앵커, 여러 번의 편집

AI 제품 이미지를 프로덕션에 활용 가능하게 만드는 패턴은 앵커링 후 편집입니다:

1. 앵커링 — 깔끔하고 표준적인 제품 이미지를 확보합니다. 실제 제품을 촬영하거나 seedream-5.0-lite/text-to-image로 콘셉트 이미지를 한 번 생성합니다(마찬가지로 $0.035).
2. 편집 — 해당 앵커 이미지를 image-to-image에 입력하여 모든 파생 버전(배경 교체, 디테일 수정, 컬러웨이)을 생성합니다. 제품의 정체성은 프롬프트가 아니라 참조 픽셀에서 비롯되므로, 모든 이미지에서 동일한 가방이 유지됩니다.

다음이 우리의 앵커 이미지입니다. 캔버스 위켄더 백으로, t2i 형제 모델로 한 번 생성하여 이후 모든 편집의 참조 이미지로 사용했습니다:

요청 구조

seedream-5.0-lite/image-to-image는 hiapi의 비동기 작업 엔드포인트에서 실행됩니다: POST /v1/tasks로 제출하고, 작업 ID를 완료될 때까지 폴링한 다음, 출력 URL을 다운로드합니다. 네 개의 입력 필드가 있으며, 모두 필수입니다:

필드	타입	설명
prompt	string	편집 명령
image_urls	array	1–14개의 공개적으로 접근 가능한 참조 이미지 URL
aspect_ratio	enum	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
resolution	enum	2K 또는 4K만 지원 — 이 모델에는 1K 옵션이 없습니다

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "Replace the white studio background: place the bag on a weathered wooden bench in a sunlit modern loft. Keep the bag itself completely unchanged.",
      "image_urls": ["https://your-cdn.com/products/weekender-anchor.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'

응답에는 data.taskId가 포함됩니다. status가 success가 될 때까지 GET /v1/tasks/{taskId}를 폴링한 다음, output[0].url을 즉시 다운로드하세요. 출력 링크는 만료되므로 파일을 자체 스토리지에 복사해야 합니다. 우리의 실행에서는 각 편집이 약 60–120초 내에 완료되었습니다.

편집 모드 1: 배경 재배치 (상품 목록 → 라이프스타일)

이커머스에서 가장 빈번한 편집: 동일한 제품, 새로운 장면. 핵심 프롬프트 기법은 대부분의 프롬프트를 변경하지 말아야 할 내용을 고정하는 데 사용한 다음, 새로운 환경을 설명하는 것입니다:

이 번트 오렌지 캔버스 위켄더 백을 완전히 그대로 유지하세요 — 동일한 모양, 동일한 색상, 동일한 손잡이, 동일한 스티칭, 짙은 갈색 가죽 트림과 황동 지퍼 포함. 흰 스튜디오 배경을 교체하세요: 가방을 햇빛이 드는 현대적인 로프트의 풍화된 나무 벤치 위에 놓고, 큰 창문으로 부드러운 아침 햇살이 들어오며, 배경에는 흐릿한 녹색 식물이 있고, 나무 벤치에는 자연스러운 접촉 그림자가 있으며, 따뜻한 잡지 라이프스타일 사진 스타일.

앵커 이미지와 비교해 보세요: 트림, 크로스 스티칭 가죽 패치, 지퍼 풀, 비율이 모두 이어집니다. 접촉 그림자가 나무 판자에 떨어지는데, 이 접지 디테일이야말로 재배치가 합성이 아닌 실제 촬영처럼 보이게 하는 요소입니다.

편집 모드 2: 정밀 디테일 수정 (하드웨어 교체)

Seedream Lite의 '정밀 편집' 라벨은 외과 수술식 수정을 의미합니다. 공급업체가 황동 하드웨어에서 무광 블랙 하드웨어로 변경했는데 다시 촬영하고 싶지 않다고 가정해 봅시다. 하나의 변경만 요청하고 나머지 모든 것을 고정하세요:

이 번트 오렌지 캔버스 위켄더 백을 완전히 원래대로 유지하세요 — 동일한 흰 배경, 동일한 구도, 동일한 조명, 동일한 캔버스 질감과 갈색 가죽 트림. 금속 하드웨어만 변경하세요: 모든 황동 지퍼, 버클, 클라스프를 무광 블랙 금속 하드웨어로 교체하세요. 다른 어떤 것도 변경하지 마세요.

지퍼, D-링, 스트랩 버클이 모두 블랙으로 바뀌었고, 캔버스 질감과 구도는 영향을 받지 않았습니다. 텍스트-투-이미지로 재생성했다면 이런 편집은 가방 전체를 은근히 다시 디자인해 버렸을 것입니다.

편집 모드 3: 컬러웨이 시리즈

제품 페이지는 모든 색상 변형이 동일한 방식으로 촬영되어야 합니다. 디자인, 트림, 구도를 고정하면서 앵커 이미지의 색상을 변경하세요:

이 위켄더 백의 디자인을 완전히 그대로 유지하세요 — 동일한 모양, 동일한 갈색 가죽 트림과 손잡이, 동일한 황동 하드웨어, 동일한 흰 스튜디오 배경, 동일한 조명과 구도. 캔버스 본체 색상만 번트 오렌지에서 짙은 포레스트 그린으로 변경하고, 원단 질감과 스티칭은 유지하세요.

'네이비 블루', '차콜 블랙', '샌드 베이지'로 반복하면 한 번의 촬영으로 다섯 SKU의 시리즈 이미지를 $0.175에 얻을 수 있습니다. 각 변형의 구도가 완전히 동일하기 때문에 제품 페이지의 색상 선택기가 조화롭게 보이는 것입니다.

Python으로 상품 목록 이미지 세트 전체 일괄 생성

프로덕션 환경에서는 한 번에 하나의 편집만 제출하지 않습니다. 작업 API는 깔끔하게 병렬화할 수 있습니다 — 모든 편집을 한꺼번에 제출한 다음 폴링하세요. 다음은 우리가 사용한 패턴입니다(세 개의 편집이 3분 이내에 동시에 완료됨):

import json, time, requests, concurrent.futures

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_HIAPI_KEY", "Content-Type": "application/json"}
ANCHOR = "https://your-cdn.com/products/weekender-anchor.jpg"

EDITS = [
    ("lifestyle", "3:2", "Keep this exact bag unchanged... place it on a weathered wooden bench in a sunlit loft..."),
    ("hardware-black", "1:1", "Change only the metal hardware to matte black. Do not alter anything else."),
    ("colorway-green", "1:1", "Change only the canvas body color to deep forest green, preserving texture and trim."),
]

def run_edit(name, aspect_ratio, prompt):
    task = requests.post(API, headers=HEADERS, json={
        "model": "seedream-5.0-lite/image-to-image",
        "input": {"prompt": prompt, "image_urls": [ANCHOR],
                  "aspect_ratio": aspect_ratio, "resolution": "2K"},
    }).json()
    task_id = task["data"]["taskId"]
    while True:
        d = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if d["status"] == "success":
            img = requests.get(d["output"][0]["url"]).content   # expires — save it now
            open(f"{name}.jpg", "wb").write(img)
            return name, len(img)
        if d["status"] == "fail":
            raise RuntimeError(f"{name}: {d.get('error')}")
        time.sleep(5)

with concurrent.futures.ThreadPoolExecutor(max_workers=3) as ex:
    for name, size in ex.map(lambda e: run_edit(*e), EDITS):
        print(f"{name}: {size} bytes")

이 코드를 실행한 후의 세 가지 실용적인 조언:

• image_urls는 반드시 공개적으로 접근 가능해야 합니다. 먼저 앵커 이미지를 CDN이나 오브젝트 스토리지에 업로드하세요. API는 요청당 최대 14개의 URL을 검증합니다.
• 출력을 즉시 저장하세요. output[0].url은 시간 제한이 있는 링크입니다. 다른 어떤 작업을 하기 전에 바이트 데이터를 자체 버킷에 먼저 복사하세요.
• 필요할 때 다중 참조 이미지를 사용할 수 있습니다. 여러 참조 이미지(동일 제품의 앞/뒤/디테일 이미지, 또는 제품과 스타일 참조 이미지)를 전달하면 패턴 원단처럼 까다로운 물건에 더 많은 정체성 신호를 제공할 수 있습니다.

비용 및 이 모델을 선택해야 할 때

2K 이미지당 $0.035를 기준으로, 현실적인 SKU당 이미지 세트 — 앵커 이미지 하나, 라이프스타일 재배치 이미지 하나, 디테일 수정 이미지 하나, 세 가지 컬러웨이 이미지 — 총 여섯 장이 $0.21입니다. 각 티어의 최신 가격은 hiapi 가격 페이지를 참조하세요.

편집기 사이에서 선택하고 있다면: 우리의 삼중 모델 image-to-image 비교에서 동일한 편집을 주요 경쟁자들에게 실행해 보았고, Nano-Banana 이커머스 가이드에서는 또 다른 앵커링 및 재배치 기술 스택을 소개합니다. 이 워크플로에서 Seedream 5.0 Lite의 강점은 명령 준수 정밀도, 14슬롯 다중 참조 이미지 입력, 그리고 SKU당 배치 처리를 푼돈 비용으로 만드는 통일된 저가입니다.

시작하기

API 키를 발급받고, 깔끔한 제품 이미지를 업로드한 다음, seedream-5.0-lite/image-to-image에 위의 라이프스타일 재배치 프롬프트를 실행하세요 — 몇 분 안에 첫 번째 파생 이미지 세트를 얻을 수 있습니다. 전체 작업 엔드포인트 참조는 hiapi 문서를 참조하세요.