hiapi API에서 seedream-4.5/image-to-image로 이커머스 제품 이미지 생성하기

제품 카탈로그는 사진 한 장이 아니라 동일한 SKU가 십여 가지 상황에서 표현된 것입니다. 흰 배경 제품 이미지, 라이프스타일 연출 이미지, 공급업체가 구성 요소를 바꾼 뒤의 리터칭, 그리고 시즌 브랜드 배경에 맞춘 버전까지 포함됩니다. 다시 촬영하거나 처음부터 다시 생성하면 매번 일관성이 깨집니다. 완전히 새로운 프롬프트는 매번 조금씩 다른 제품을 그려내기 때문입니다.

seedream-4.5/image-to-image는 바로 이를 위해 만들어졌습니다. 실제 제품 사진(또는 여러 장의 참조 이미지)에 자연어 편집 지시문을 더하면 편집된 이미지를 반환하며, 제품의 실제 형상, 소재, 브랜드 표식은 그대로 유지하고 요청한 부분만 바꿉니다. 배경, 마모 디테일, 또는 통일된 비주얼 아이덴티티에 필요한 색조 보정 등입니다. hiapi에서는 다른 모든 모델과 마찬가지로 동일한 비동기 /v1/tasks 엔드포인트로 실행되며, 이미지당 $0.045입니다.

아래 두 예시는 모두 실제 API 호출이며, 정확한 프롬프트와 생성된 이미지를 보여줍니다.

왜 재생성 대신 편집인가

텍스트→이미지와 이미지→이미지는 서로 다른 문제를 해결합니다:

• 텍스트→이미지는 설명을 바탕으로 제품을 무에서 창조합니다. 콘셉트 디자인에는 적합하지만 제품 카탈로그에는 부적합합니다. 두 번 요청하면 서로 다른 두 개의 머그컵이 나옵니다.
• 이미지→이미지 편집은 실제 제품 사진을 출발점으로 삼습니다. 모델은 참조 이미지를 형상, 비율, 브랜드 표식의 기준 진실로 취급하고 프롬프트가 지정한 내용만 바꿉니다. 이것이 실제 상품 리스팅에 안전한 이유입니다. 출력물 속의 제품은 여전히 당신의 제품입니다.

실제 워크플로는 다음과 같습니다. 각 SKU마다 깨끗한 기본 사진 하나를 유지하고(평범한 스튜디오 사진이 참조로 충분합니다), 필요한 각 상황마다 seedream-4.5/image-to-image를 한 번씩 실행합니다. 라이프스타일 장면, 배경 교체, 브랜드 일관성 있는 배경, 디테일 복원 등이며, 매번 다시 촬영하거나 처음부터 다시 프롬프트하지 않습니다.

예시 1: 라이프스타일 장면으로 배경 교체

기본 참조: 흰 배경 위 세라믹 핸드드립 드리퍼의 평범한 스튜디오 사진.

모델에 보낸 편집 프롬프트:

Keep the ceramic pour-over dripper's exact shape, glaze color, and proportions
unchanged. Place it on a warm wood kitchen counter next to a steaming ceramic
mug and an open burlap coffee bag. Warm golden-hour side lighting, shallow
depth of field, soft shadows. Do not alter the dripper itself in any way —
only change the surrounding scene.

결과는 드리퍼의 실루엣과 유약 색상을 픽셀 단위로 식별 가능하게 유지하면서, 평범한 제품 사진만으로는 만들어낼 수 없는 생생한 라이프스타일 장면에 배치합니다. 재촬영도, 별도의 합성 단계도 필요 없습니다.

예시 2: 브랜드 배경 위에서 제품 통일하기

기본 참조: 흰색 캔버스 스니커즈의 평범한 스튜디오 사진.

모델에 보낸 편집 프롬프트:

Keep the sneaker's stitching, eyelets, laces, and canvas texture exactly as
shown. Replace the background with a solid terracotta studio backdrop and
place the sneaker on a matching terracotta pedestal. Even, soft studio
lighting from the upper left, subtle contact shadow. Do not change the
sneaker's shape, color, or any printed details.

이것이 제품 카탈로그를 시각적으로 통일하는 패턴입니다. 하나의 배경 처리를 선택한 다음, 각 SKU의 기본 사진에 동일한 편집 지시문을 적용합니다. 제품은 서로 다르지만 배경, 조명 방향, 색조는 일관되게 유지됩니다. 이를 제어하는 것은 제품 자체가 아니라 프롬프트이기 때문입니다.

API 직접 호출하기

seedream-4.5/image-to-image는 hiapi의 비동기 작업 엔드포인트로 실행됩니다. 작업을 제출하고, 완료될 때까지 폴링한 다음, 결과를 다운로드하세요.

curl:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5/image-to-image",
    "input": {
      "prompt": "Keep the product exactly as shown. Replace the background with a solid terracotta studio backdrop and matching pedestal. Even soft studio lighting from the upper left.",
      "image_urls": ["https://your-storage.example.com/base-product-photo.jpg"],
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

응답은 task_id를 반환합니다. GET /v1/tasks/{task_id}를 status가 succeeded가 될 때까지 폴링한 다음, output[0].url에서 이미지 URL을 읽으세요. 이 URL은 시간 제한이 있으므로 즉시 다운로드하세요.

Python(작업 제출 + 폴링 + 다운로드):

import os
import time
import requests

API_BASE = "https://api.hiapi.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}


def edit_product_image(prompt: str, image_urls: list[str],
                        aspect_ratio: str = "1:1", resolution: str = "2K") -> bytes:
    resp = requests.post(
        f"{API_BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "seedream-4.5/image-to-image",
            "input": {
                "prompt": prompt,
                "image_urls": image_urls,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
            },
        },
        timeout=30,
    )
    resp.raise_for_status()
    task_id = resp.json()["task_id"]

    while True:
        poll = requests.get(f"{API_BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
        poll.raise_for_status()
        data = poll.json()
        if data["status"] == "succeeded":
            image_url = data["output"][0]["url"]
            return requests.get(image_url, timeout=30).content
        if data["status"] == "failed":
            raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
        time.sleep(3)

제품 카탈로그 일괄 편집

위 패턴은 제품 카탈로그에 바로 일반화할 수 있습니다. (sku, base_photo_url) 목록을 유지하고, 각 항목에 동일한 편집 지시문(또는 SKU별 변형)을 적용한 뒤, SKU를 키로 결과를 기록하세요.

CATALOG = [
    {"sku": "dripper-ceramic-01", "base_url": "https://your-storage.example.com/dripper-01.jpg"},
    {"sku": "sneaker-canvas-white", "base_url": "https://your-storage.example.com/sneaker-white.jpg"},
    {"sku": "mug-stoneware-02", "base_url": "https://your-storage.example.com/mug-02.jpg"},
]

BACKDROP_PROMPT = (
    "Keep the product's exact shape, materials, and any printed branding "
    "unchanged. Replace the background with a solid terracotta studio "
    "backdrop and matching pedestal. Even soft studio lighting from the "
    "upper left, subtle contact shadow. Do not alter the product itself."
)

for item in CATALOG:
    image_bytes = edit_product_image(
        prompt=BACKDROP_PROMPT,
        image_urls=[item["base_url"]],
        aspect_ratio="1:1",
        resolution="2K",
    )
    with open(f"{item['sku']}-branded.jpg", "wb") as f:
        f.write(image_bytes)
    print(f"{item['sku']}: done")

이미지당 $0.045로 계산하면, 50개 SKU 카탈로그의 배경 처리 한 번은 약 $2.25입니다. 각 작업이 독립적으로 실행되므로 순차 실행 대신 스레드 풀이나 작업 큐를 통해 병렬화할 수 있습니다.

image_urls는 단일 호출당 최대 14장의 참조 이미지를 받을 수 있으므로, 참조 이미지 한 장으로 복잡한 편집을 지원하기 어려울 때 더 고급 변형은 동일 제품의 여러 각도(정면, 측면, 디테일)를 한 번에 모델에 전달할 수 있습니다.

자주 묻는 질문

seedream-4.5/image-to-image는 제품 자체를 바꾸나요, 아니면 장면만 바꾸나요? 편집 지시문을 엄격히 따릅니다. 프롬프트가 배경, 조명, 상황 변화만 설명하고 제품 보존을 명시적으로 요구하면, 제품의 형상, 색상, 인쇄 디테일은 여러 번의 편집에서 일관되게 유지됩니다. 이것이 일회성 콘셉트 이미지가 아니라 실제 제품 카탈로그에 사용할 수 있는 이유입니다.

단일 호출로 참조 이미지를 몇 장까지 보낼 수 있나요? image_urls에 최대 14개의 공개 이미지 URL을 넣을 수 있습니다. 대부분의 단일 제품 편집에는 한 장(기본 사진)이면 충분하며, 동일 물건의 여러 각도 디테일을 모델이 조율하길 원할 때 여러 참조 이미지가 도움이 됩니다.

어떤 해상도를 지원하나요? resolution은 2K 또는 4K를 받습니다. 이 모델에는 1K 등급이 없습니다.

카탈로그 전체를 일괄 편집하려면 비용이 얼마나 드나요? 해상도 등급과 관계없이 이미지당 $0.045입니다. 100개 SKU 카탈로그의 편집 한 번은 약 $4.50입니다.

일괄 작업 속도를 높이기 위해 편집을 병렬로 실행할 수 있나요? 가능합니다. 각 작업이 서로 독립적이므로 여러 /v1/tasks 호출을 동시에 제출하고(계정의 속도 제한 준수) 병렬로 폴링하는 것이 대규모 카탈로그를 처리하는 가장 빠른 방법입니다.

직접 사용해 보기

전체 파라미터 참조와 실시간 가격은 모델 페이지와 가격 페이지를 참고하세요. 위 작업 엔드포인트의 정확한 요청/응답 형식은 작업 생성 문서를 참고하세요. 다른 모델 등급으로 유사한 워크플로를 설정 중이라면, seedream-5.0-lite 이커머스 가이드에서 단일 SKU 고정 후 편집 패턴을 더 자세히 다룹니다.

API 키를 발급받아 실제 제품 사진으로 첫 편집을 실행해 보세요. 위 코드는 오늘 바로 복사·붙여넣기하여 hiapi API에서 실행할 수 있습니다.