hiapi API로 seedream-4.5/text-to-image를 사용하여 이커머스 제품 이미지 생성하기

모든 제품 이미지가 사진 한 장에서 시작되는 것은 아닙니다. 샘플이 존재하기 전, 사진작가를 섭외하기 전, 또는 시즌 프로모션을 위해 내일 아침까지 배너가 필요한 상황에서, 당신은 단지 텍스트 설명만으로 이미지를 생성해야 합니다 — 깔끔한 제품 목업, 라이프스타일 장면, 실제로 선명한 헤드라인 텍스트가 들어간 프로모션 이미지 말이죠.

seedream-4.5/text-to-image는 바로 이런 제로샷 시나리오를 위해 만들어졌습니다. 평범한 문장 설명을 주면 참조 사진 없이도 사진처럼 사실적인 이미지를 반환하며, 여기에는 정확한 이미지 내 텍스트도 포함됩니다 — 이는 대부분의 텍스트-투-이미지 모델이 여전히 실수하는 부분입니다. hiapi에서는 다른 모든 모델과 마찬가지로 동일한 비동기 /v1/tasks 엔드포인트를 통해 실행되며, 가격은 이미지당 $0.045, 해상도는 2K 또는 4K입니다.

아래 두 예시는 모두 실제 API 호출로, 각자의 정확한 프롬프트와 생성된 이미지를 보여줍니다 — 후처리 편집은 전혀 없습니다.

제로샷 생성 vs. 실제 사진 편집

seedream-4.5는 서로 다른 작업을 맡는 두 가지 모델 형태로 출시되었습니다:

• seedream-4.5/text-to-image(이 글의 주제)는 입력 사진 없이 설명으로부터 이미지를 생성합니다. 제품에 깔끔한 참조 사진이 아직 없을 때, 카탈로그에 존재하지 않는 장면이나 콘셉트가 필요할 때, 또는 결과물이 특정 실물 제품의 사진이 아니라 마케팅 아트워크일 때 사용하세요.
• seedream-4.5/image-to-image는 이미 가지고 있는 실제 제품 사진을 편집하여 정확한 형태와 브랜드 아이덴티티를 유지하면서 배경이나 상황을 바꿉니다 — 해당 워크플로는 이미지-투-이미지 이커머스 가이드를 참고하세요.

특정 실물 SKU와 픽셀 단위로 일치해야 한다면 편집 모델을 사용하세요. 완전히 새로운 것 — 콘셉트 렌더링, 시즌 배너, 아직 존재하지 않는 장면 — 을 생성해야 한다면 텍스트-투-이미지가 적합한 도구이며, 이 글에서 다루는 내용입니다.

예시 1: 텍스트로 생성한 스튜디오 제품 사진

모델에 보낸 프롬프트:

a minimalist amber glass skincare serum bottle with a brushed silver cap
standing on a polished travertine surface, soft diffused window light
casting a gentle gradient shadow, sage green linen backdrop, one small
dried eucalyptus sprig beside the bottle, e-commerce product photography,
sharp focus, clean composition, no text, no logo, subtle reflection on
the stone surface

요청 파라미터: aspect_ratio: "1:1", resolution: "2K".

여기에는 병도, 스튜디오도, 사진작가도 없습니다 — 그림자의 감쇠, 석재 표면의 반사, 부드러운 창문 빛 모두 설명에서 비롯됩니다. 이것이 편집 대비 텍스트-투-이미지의 강점입니다: 아직 개발 중인 제품을 위한 상품 목록 목업이나 무드보드를 촬영 일정을 잡을 필요 없이 약 1분 만에 생성할 수 있습니다.

예시 2: 실제로 선명한 헤드라인 텍스트가 있는 프로모션 이미지

텍스트 렌더링은 이 모델 작업에서 더 어려운 절반입니다 — 대부분의 이미지 생성기는 깨지거나 철자가 틀린 텍스트를 만들어냅니다. 재시도 없이 두 개의 프롬프트:

플랫레이 프로모션 배너:

a flat-lay e-commerce marketing banner for a summer skincare sale, an
arrangement of amber glass bottles and dried botanicals on a warm
terracotta background, bold sans-serif headline text 'SUMMER GLOW SALE'
near the top in cream white lettering, smaller text 'Up to 30% Off'
beneath it in matching cream, clean modern layout with generous negative
space on the right third, professional marketing design, crisp legible
typography, warm cinematic lighting

요청 파라미터: aspect_ratio: "4:3", resolution: "2K".

세로형 스토리 그래픽:

a vertical social media story graphic for a candle brand product launch,
a single black matte ceramic candle jar centered on a deep charcoal
gradient background, bold white headline text 'NEW ARRIVAL' near the
top, smaller subtext 'Shop the Collection' below the product, minimalist
premium aesthetic, soft rim lighting on the candle jar, generous margin
for mobile screen safe zones

요청 파라미터: aspect_ratio: "9:16", resolution: "2K".

두 개의 헤드라인과 두 개의 서브카피 모두 철자가 정확하고 자간이 고르며, 프롬프트에서 요구한 위치에 정확히 놓였습니다 — 첫 생성에서 그대로, 재시도 없이. 바로 이 신뢰성 덕분에 마감이 촉박한 프로모션 소재에 텍스트-투-이미지를 쓸 수 있습니다: 디자이너가 만들어야 했던 프로모션 배너나 스토리 그래픽을 이제 API 호출 한 번으로 초안 작성할 수 있습니다.

API 직접 호출하기

seedream-4.5/text-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/text-to-image",
    "input": {
      "prompt": "a minimalist amber glass skincare serum bottle on a travertine surface, soft window light, sage linen backdrop, e-commerce product photography, no text",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

응답은 task_id를 반환합니다. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 다음, output[0].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 generate_product_image(prompt: str, aspect_ratio: str = "1:1",
                            resolution: str = "2K") -> bytes:
    resp = requests.post(
        f"{API_BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "seedream-4.5/text-to-image",
            "input": {
                "prompt": prompt,
                "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)

제품 라인 전체를 일괄 생성하기

동일한 호출을 전체 제품 라인으로 확장할 수 있습니다: (name, prompt, aspect_ratio) 튜플 목록을 만들어 각 항목을 하나의 작업에 대응시키고, 이름별로 디스크에 저장하세요.

JOBS = [
    {
        "name": "serum-hero",
        "prompt": "a minimalist amber glass skincare serum bottle on a travertine "
                   "surface, soft window light, sage linen backdrop, e-commerce "
                   "product photography, no text",
        "aspect_ratio": "1:1",
    },
    {
        "name": "sale-banner",
        "prompt": "a flat-lay e-commerce marketing banner for a summer skincare "
                   "sale, amber glass bottles on a terracotta background, bold "
                   "headline text 'SUMMER GLOW SALE', smaller text 'Up to 30% Off'",
        "aspect_ratio": "4:3",
    },
    {
        "name": "story-launch",
        "prompt": "a vertical social story graphic, a black matte ceramic candle "
                   "jar on a charcoal gradient background, bold white headline "
                   "'NEW ARRIVAL', subtext 'Shop the Collection'",
        "aspect_ratio": "9:16",
    },
]

for job in JOBS:
    image_bytes = generate_product_image(
        prompt=job["prompt"],
        aspect_ratio=job["aspect_ratio"],
        resolution="2K",
    )
    with open(f"{job['name']}.jpg", "wb") as f:
        f.write(image_bytes)
    print(f"{job['name']}: done")

이미지당 $0.045로 계산하면, 히어로 이미지, 배너, 스토리 그래픽을 모두 합친 20개 소재의 시즌 런칭 비용은 약 $0.90입니다. 각 작업이 독립적이므로 여러 /v1/tasks 호출을 동시에 제출하고 병렬로 폴링하는 것(계정의 속도 제한 준수)이 목록을 순차 실행하는 것보다 빠릅니다.

seedream-5.0-pro와 비교

hiapi는 또한 이커머스 텍스트-투-이미지 작업을 위한 별도의 더 새로운 티어로 seedream-5.0-pro를 운영합니다. 둘은 같은 모델이 아닙니다: 가격, 해상도 옵션, 출력 특성이 모두 다르며, seedream-5.0-pro의 워크플로는 전용 가이드에서 다룹니다. 결과물에 신뢰할 수 있는 이미지 내 텍스트 — 프로모션 배너, 스토리 그래픽, 프로모션 카드 — 가 필요하고, 해상도 티어별 가격 책정을 고민하지 않으면서 이미지당 $0.045의 고정 가격을 원한다면, seedream-4.5/text-to-image가 바로 선택해야 할 모델입니다.

자주 묻는 질문

seedream-4.5/text-to-image는 참조 사진을 받나요? 아니요 — text-to-image는 prompt, aspect_ratio, resolution만 받습니다. 새 이미지를 생성하는 대신 기존 제품 사진을 편집하려면 seedream-4.5/image-to-image를 사용하세요.

어떤 해상도와 종횡비를 지원하나요? resolution은 2K 또는 4K만 허용됩니다 — 1K 티어는 없습니다. aspect_ratio는 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9를 허용합니다.

이미지 내 헤드라인 텍스트를 안정적으로 렌더링하나요? 네 — 위의 두 프로모션 예시 모두 첫 생성에서 여러 단어로 된 헤드라인과 서브카피를 철자 오류나 깨진 글리프 없이 올바르게 렌더링했습니다.

제품 라인 전체를 일괄 생성하는 비용은 얼마인가요? 해상도 티어와 관계없이 이미지당 $0.045입니다. 20장 시즌 세트는 약 $0.90, 100장 세트는 약 $4.50입니다.

배치 작업을 가속화하기 위해 생성을 병렬로 실행할 수 있나요? 네 — 각 작업이 독립적이므로 여러 /v1/tasks 호출을 동시에 제출하고 병렬로 폴링하는 것이 대량 소재를 가장 빠르게 생산하는 방법입니다.

직접 시도해 보세요

전체 파라미터 참조와 실시간 가격은 모델 페이지와 가격 페이지에서 확인하세요. 이 모델의 더 많은 프롬프트 패턴은 seedream-4.5 텍스트-투-이미지 프롬프트 레시피를 참고하세요. 워크플로가 빈 페이지 대신 실제 제품 사진에서 시작한다면, seedream-4.5 이미지-투-이미지 이커머스 가이드에서 직접 편집하는 방법을 다룹니다.

API 키를 발급받아 첫 제품 이미지나 프로모션 배너를 생성해 보세요 — 위 코드는 오늘 바로 복사해서 hiapi API에 대해 실행할 수 있습니다.