Grok Imagine Quality 이미지-투-이미지로 전자상거래 제품 이미지 만들기

새로운 각도, 시즌 배너, 마켓플레이스 템플릿마다 제품을 다시 촬영하는 것은 느리고 비쌉니다. grok-imagine-quality/image-to-image는 더 좁지만 더 실용적인 문제를 해결합니다. 깨끗한 참조 사진 한 장과 텍스트 프롬프트를 주면, 바로 그 제품—같은 모양, 같은 색상, 같은 비율—을 새로운 장면에 배치합니다. 스튜디오 촬영 사진 한 장이 라이프스타일 컷, 플랫레이, 사용 중인 컷으로 바뀌며 두 번째 실제 촬영이 필요 없습니다.

이 가이드는 hiapi API에서의 실제 전자상거래 워크플로를 안내합니다. 기본 제품 사진을 생성하고, grok-imagine-quality/image-to-image로 세 번의 장면 변환을 수행하며, 동일한 패턴을 전체 제품 카탈로그에 일괄 적용합니다—실행 가능한 코드와 현재 가격과 함께.

사전 요구 사항:

• 내 대시보드에서 hiapi API 키 가져오기
• Python 3.9+ 및 requests (또는 curl 직접 사용)
• 기본 제품 이미지가 공개 URL에 호스팅되어 있어야 합니다—작업 API는 업로드가 아니라 URL을 통해 image_urls를 가져옵니다

두 번째 촬영 대신 이미지-투-이미지를 쓰는 이유

텍스트-투-이미지 모델은 멋진 커피 드리퍼를 생성할 수 있지만, 고객이 이미 제품 사진에서 알아보는 정확한 실루엣, 유약 색상, 주둥이 각도—즉 당신의 커피 드리퍼는 생성하지 못합니다. grok-imagine-quality/image-to-image는 바로 그 물체를 참조로 삼아 새로운 환경에 다시 렌더링하며, 이것이 "제품 사진 한 장"과 "우리 제품의 사진" 사이의 차이입니다.

덕분에 전자상거래의 반복 요구에 적합합니다. SKU당 대표 이미지 한 장을 만든 뒤, 제품 갤러리, 광고, 마켓플레이스 리스팅을 위한 N개의 변형(라이프스타일 장면, 플랫레이, 사용 중, 시즌 배경)을 만들 수 있으며, 매번 사진 스튜디오를 예약할 필요가 없습니다.

워크플로: 기본 사진 한 장, 세 번의 장면 편집

여기서 기본 사진은 gpt-image-2/text-to-image로 생성했습니다(1K에서 장당 $0.03)—깨끗하고 조명이 좋은 제품 사진이라면 이미 가지고 있는 실제 사진을 포함해 무엇이든 참조로 사용할 수 있습니다:

그런 다음 이 단일 이미지 URL을 세 번의 grok-imagine-quality/image-to-image 호출에서 재사용하며, 각 호출은 목표 장면 하나씩입니다:

세 결과 모두에서 드리퍼의 비율, 유약 색상, 손잡이 모양이 정확히 동일하게 유지됩니다—주변 장면만 바뀝니다. 이러한 일관성이 바로 여기서 각 장면을 개별 t2i로 생성하는 대신 i2i를 사용하는 핵심 가치입니다. 개별 t2i는 서로 다르게 보이는 제품 세 개를 만들어냅니다.

요청 구조와 가격

grok-imagine-quality/image-to-image는 작고 엄격한 입력 스키마를 받습니다—strength나 시드 같은 추가 필드는 거부됩니다:

필드	필수	설명
prompt	예	새 장면을 설명하며, 참조 이미지의 모양/색상/비율을 유지하도록 모델에 명확히 지시
image_urls	예	1–3개의 공개 URL. 여러 참조 이미지를 사용할 경우 출력 화면은 첫 번째 URL을 따름
resolution	아니오	1k 또는 2k (소문자)
aspect_ratio	아니오	auto (기본값, 입력 화면 따름) 또는 16:9, 1:1, 9:16 같은 고정 비율

2026-08 기준 가격(hiapi 가격 페이지에서 확인): grok-imagine-quality/image-to-image는 1K 장당 $0.09, 2K 장당 $0.11입니다. gpt-image-2/text-to-image의 기본 스튜디오 사진은 1K에서 $0.03입니다. 위와 같은 4장 이미지 세트—기본 사진 한 장과 세 번의 장면 편집—의 총비용은 $0.30입니다.

코드: 작업 제출 및 폴링

hiapi의 모든 생성은 동일한 비동기 작업 수명 주기를 따릅니다—제출하고, status가 success가 될 때까지 GET /v1/tasks/{id}를 폴링한 다음, output[0].url을 즉시 다운로드합니다(URL은 만료됨). 전체 계약은 비동기 작업 API 참조에서 확인할 수 있습니다. 다음은 i2i 호출의 구체적인 예입니다:

import requests
import time

API_BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

def edit_product_scene(base_image_url: str, prompt: str) -> str:
    payload = {
        "model": "grok-imagine-quality/image-to-image",
        "input": {
            "prompt": prompt,
            "image_urls": [base_image_url],
            "resolution": "1k",
        },
    }
    resp = requests.post(API_BASE, headers=HEADERS, json=payload, timeout=60)
    task_id = resp.json()["data"]["taskId"]

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

일관성은 실제로 프롬프트에서 나옵니다—strength나 참조 가중치 파라미터가 없으므로 문구가 그 역할을 해야 합니다:

Place this ceramic pour-over coffee dripper on a rustic wooden kitchen
countertop, warm morning sunlight streaming in from the left, a few
coffee beans scattered near the base, shallow depth of field, lifestyle
e-commerce photography, keep the dripper's shape, color and proportions
identical to the reference

그 마지막 절—"keep the shape, color and proportions identical to the reference"(모양, 색상, 비율을 참조 이미지와 동일하게 유지)—은 테스트에서 측정 가능한 차이를 만들었습니다. 이것을 빼면 모델은 참조 이미지를 더 느슨하게 다루며, 비율을 다시 그리고 약간 일반적인 디테일을 섞어 넣습니다.

한 가지 주의: 정확한 포즈 제어를 기대하지 마세요. 장면 교체 시 "같은 각도"를 요청해도 엄격히 지켜지지 않습니다—물체의 방향은 새 장면에 맞게 자연스럽게 다시 조정되는 경향이 있습니다. 정확한 방향이 중요하다면 유지 절에 명시하세요(예: "주둥이가 왼쪽을 향하도록 유지").

전체 카탈로그 일괄 처리

같은 호출을 카탈로그 작업으로 바로 확장할 수 있습니다—하나의 제품을 하드코딩하는 대신 (SKU, 기본 이미지, 장면 프롬프트) 튜플을 반복합니다:

CATALOG = [
    {"sku": "dripper-ceramic-01", "base_url": "https://cdn.example.com/dripper-01-base.jpg"},
    {"sku": "kettle-gooseneck-02", "base_url": "https://cdn.example.com/kettle-02-base.jpg"},
    # ...
]

SCENE_PROMPTS = {
    "lifestyle": "Place this product on a rustic wooden kitchen countertop, warm morning "
                 "sunlight, lifestyle e-commerce photography, keep shape, color and "
                 "proportions identical to the reference",
    "flatlay": "Place this product on a white marble countertop, top-down flat lay, soft "
               "diffused daylight, keep shape, color and proportions identical to the reference",
}

results = []
for item in CATALOG:
    for scene_name, prompt in SCENE_PROMPTS.items():
        url = edit_product_scene(item["base_url"], prompt)
        results.append({"sku": item["sku"], "scene": scene_name, "url": url})
        # download + upload to your own storage here — output URLs expire

작업 API에는 기본 idempotency_key 필드가 없으므로, 배치 작업이 충돌 후 안전하게 재실행되어야 한다면 API가 중복을 잡아주기를 기대하지 말고 자체 저장소에서 (sku, scene_name) 기준으로 중복 제거한 뒤 다시 제출하세요.

장당 $0.09로 계산하면, 200개 SKU 카탈로그에서 각각 3개의 장면 변형을 만들면 총 $54가 듭니다—특히 계절에 따라 재조정되는 카탈로그의 경우, 그만큼 많은 장면 사진을 촬영하는 스튜디오 비용과 비교해볼 만합니다.

자주 묻는 질문

grok-imagine-quality/image-to-image는 한 번의 호출로 배치 또는 여러 이미지 출력을 지원하나요? 아니요—한 번의 image_urls 제출(참조 이미지 1–3장)은 작업당 출력 이미지 한 장을 생성합니다. 위에서처럼 별도 작업 호출을 반복하여 장면을 일괄 처리하세요.

출력의 정확한 카메라 각도를 제어할 수 있나요? 직접 제어는 불가능합니다—카메라/포즈 파라미터가 없습니다. 방향은 새 장면에 맞게 다시 조정되는 경향이 있습니다. 특정 각도가 중요하다면 "모양/색상/비율 유지" 지시와 함께 프롬프트에 명확히 적으세요.

기본 티어 grok-imagine/image-to-image와 어떻게 다른가요? Quality 티어는 더 비싸지만(기본 티어와 달리 $0.09–$0.11), 더 큰 장면 변화에서 제품 정체성을 더 안정적으로 유지합니다. 단순 배경 교체라면 기본 티어 전자상거래 워크플로 가이드가 더 저렴한 경로를 다룹니다—장면 변환이 더 극적일 때(예: 단순 배경이 아니라 스튜디오에서 라이프스타일로) Quality를 선택하세요.

원본 사진이 아직 공개 URL에 없다면 어떻게 하나요? 먼저 아무 객체 스토리지나 CDN에 업로드하세요—작업 API는 서버 측에서 URL을 가져와 image_urls를 해석하므로 로컬 파일 경로나 데이터 URI는 작동하지 않습니다.

직접 시도해 보기

전체 요청/응답 구조, 실시간 플레이그라운드, 현재 가격은 grok-imagine-quality/image-to-image 모델 페이지에서 확인할 수 있습니다. 작업 API가 아직 익숙하지 않다면 단계별 통합 가이드에서 인증, 폴링, 오류 처리에 대해 더 깊이 다룹니다.