사용 가이드
전자상거래 제품 사진을 위한 Wan 2.7 텍스트-이미지: API 호출 한 번으로 4K 스튜디오급 이미지 생성
hiapi의 wan2.7-image/text-to-image로 메인 이미지, 연출 이미지, 패키징 이미지, 4K 매크로 이미지를 생성하는 실측 검증 워크플로 — 정확한 프롬프트, 실제 소요 시간, 통일된 $0.08 가격 포함
이 가이드의 모든 이미지는 작성 중에 hiapi 작업 API를 통해 wan2.7-image/text-to-image로 생성되었습니다. 제시된 프롬프트는 실제로 사용된 프롬프트이며, 소요 시간도 해당 실행의 실제 벽시계 시간입니다. 온라인으로 판매하며 상품 목록 이미지, 연출 이미지, 패키징 렌더링 또는 확대 가능한 디테일 이미지가 필요하지만 스튜디오 예약은 원하지 않는다면, 이것이 바로 필요한 워크플로입니다.

제품 사진에 Wan 2.7 Image를 사용하는 이유
Wan 2.7 Image Pro(모델 ID wan2.7-image/text-to-image)는 통이만샹의 플래그십 텍스트-이미지 모델입니다. 전자상거래 작업에 특히 적합하게 만드는 세 가지 특성이 있습니다:
- 최대 4K 출력 지원. 전자상거래 플랫폼의 확대 뷰어와 주문형 인쇄는 일반적인 1K 기본값보다 더 많은 픽셀을 원합니다. Wan 2.7은 4096×4096을 기본 지원합니다 — 업스케일링이 필요 없습니다.
- 강력한 프롬프트 준수 능력. 제품 이미지는 구도적입니다: 이 병을, 저 표면 위에, 이쪽에서 조명하여. 저희 실행에서 재질 설명("프로스트 유리", "브러시드 알루미늄"), 조명 방향, 소품 배치가 모두 한 번에 정확히 반영되었습니다.
- 통일된 가격. hiapi에서 모든 해상도 이미지당 $0.08입니다 — 1K, 2K, 4K가 동일하게 청구됩니다(실시간 가격 페이지와 대조 확인 완료). 대부분의 프리미엄 모델은 4K에 할증을 부과하므로, 4K 중심 워크플로라면 통일 요금이 더 경제적인 선택입니다. 자세한 비교는 아래를 참조하세요.
또한 영어와 중국어 프롬프트를 모두 받습니다. 제품 카피 팀은 중국어를 사용하지만 상점은 영어 사용자를 대상으로 하는 경우에 중요합니다.
빠른 시작: POST 한 번, 폴링 한 번
Wan 2.7 Image는 hiapi의 비동기 작업 API에서 실행됩니다. 작업을 제출하고 완료될 때까지 폴링한 다음 출력을 다운로드합니다. 먼저 빠른 시작 가이드에서 API 키를 받으세요.
제출:
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-image/text-to-image",
"input": {
"prompt": "Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography",
"aspect_ratio": "1:1",
"resolution": "2K"
}
}'
응답의 data.taskId에 작업 ID가 포함됩니다. status가 success가 될 때까지 상세 엔드포인트를 폴링합니다:
import requests, time
API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def generate(prompt, aspect_ratio="1:1", resolution="2K", timeout=600):
r = requests.post(API, headers=HEADERS, json={
"model": "wan2.7-image/text-to-image",
"input": {"prompt": prompt, "aspect_ratio": aspect_ratio,
"resolution": resolution},
})
task_id = r.json()["data"]["taskId"]
deadline = time.time() + timeout
while time.time() < deadline:
task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
if task["status"] == "success":
return requests.get(task["output"][0]["url"]).content
if task["status"] == "fail":
raise RuntimeError(task.get("error"))
time.sleep(5)
raise TimeoutError(task_id)
png_bytes = generate("...") # save immediately — see the expiry note below
저희 실행에서 작업 생성은 약 2초 만에 반환되었고, 2K 생성은 60–75초 내에 완료되었으며 4K 이미지는 86초가 걸렸습니다. 폴링 오버헤드를 포함하면 이미지당 약 1분 30초를 예산으로 잡으세요.
프로덕션에 연결하기 전에 두 가지 운영 주의사항이 있습니다:
- 출력 URL은 만료됩니다.
output[0].url에는expireAt타임스탬프가 포함됩니다 — CDN 리소스가 아닌 임시 링크입니다. 작업이 성공하는 순간 바이트를 다운로드하여 자체 스토리지에 저장해야 합니다. 이 문제로 곤란을 겪은 적이 있다면, hiapi 출력 URL이 404를 반환하는 이유와 대처 방법에서 실패 패턴을 다루었습니다. - 가로세로 비율 목록은 엄격합니다. Wan 2.7 Image는
1:1,16:9,4:3,21:9,3:4,9:16,8:1,1:8만 허용합니다. 그 외의 비율 —3:2나4:5같은 일반적인 사진 비율 포함 — 은400 INVALID_REQUEST를 반환하며 메시지에 허용 목록이 나열됩니다. 저희는 실제로 겪었습니다: 1536×1920 요청(4:5로 단순화됨)이 거부되었고,3:4로 다시 제출하자 성공했습니다. Instagram의 4:5가 필요하다면3:4로 생성한 후 자르세요.
모든 제품 목록에 필요한 네 가지 이미지
다음은 네 가지 대표적인 전자상거래 이미지 유형이며, 각각 실제 사용된 프롬프트와 편집되지 않은 출력이 첨부되어 있습니다.
1. 흰색 배경 메인 이미지
Amazon, eBay 및 대부분의 전자상거래 플랫폼은 메인 목록 이미지에 순수 흰색 배경을 요구합니다. 프롬프트의 핵심: 배경을 명시적으로 지정하고("이음새 없는 순수 흰색 배경"), 제품이 떠 보이지 않도록 "부드러운 접촉 그림자"를 요구하며, 사진작가처럼 조명 설정을 묘사합니다.
Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography

1:1 / 2K로 생성, 61초 소요. 재질 렌더링 — 확산을 통해 스포이드가 보이는 프로스트 유리, 캡의 브러시드 메탈 질감 — 이 바로 "강력한 프롬프트 준수 능력"의 결과입니다.
2. 연출 이미지
보조 목록 이미지는 사용 장면을 전달합니다. 제품을 고객이 상상하는 사용 장소에 놓고 프롬프트에 스타일링 요구사항을 담으세요: 표면, 소품, 조명 방향, 심도.
A frosted glass serum bottle with a brushed aluminum dropper cap standing on a white marble bathroom counter beside a folded beige linen towel and a sprig of eucalyptus, soft morning window light from the left, shallow depth of field, warm lifestyle product photography for an online store listing

요구된 모든 요소가 제자리에 있습니다: 대리석 카운터, 접힌 타월, 유칼립투스, 왼쪽 창가 빛, 배경 감쇠. 이것은 프롬프트 준수 능력이 가장 중요한 이미지 유형입니다. 불필요하거나 누락된 소품 하나가 곧 재생성을 의미하기 때문입니다.
3. 읽을 수 있는 브랜드 텍스트가 있는 패키징 이미지
텍스트 렌더링은 대부분의 이미지 모델이 제품 작업에서 실패하는 지점입니다. 짧고 명확한 텍스트는 Wan 2.7에서 안정적으로 렌더링됩니다 — 정확한 문자열을 따옴표로 묶고 타이포그래피를 묘사하세요:
Product packaging shot: a matte sage-green cardboard box with the brand name "VELA" printed in clean white sans-serif capital letters on the front panel, standing next to a matching frosted glass serum bottle, studio lighting on a light gray seamless background, sharp focus, e-commerce product photography

"VELA"는 한 글자도 틀리지 않고 렌더링되었습니다. 테스트 실행에서 솔직한 주의사항 하나: 이는 직접 명시한 짧은 문자열에 적용됩니다. 배너 이미지의 초기 초안에서 라벨을 모델 재량에 맡겼을 때, 병 위에 그럴듯한 난수 문자("SERUM SERUE")를 만들어냈습니다 — 따라서 원하는 정확한 텍스트를 인용하거나 "라벨 없음, 텍스트 없음, 로고 없음"을 프롬프트하고 나중에 라벨을 추가하세요. 생성된 이미지의 모든 텍스트는 게시 전에 반드시 교정하세요.
4. 4K 매크로 디테일 이미지
확대 디테일 이미지는 프리미엄 가격 책정을 뒷받침합니다. 여기서 4K 출력과 통일 요금이 빛을 발합니다 — 동일한 $0.08로 4096×4096 파일을 얻습니다:
Extreme close-up macro photograph of fine water droplets on the frosted glass surface of a cosmetic serum bottle, the brushed aluminum cap edge visible at the top of the frame, crisp micro-detail, controlled studio reflections, luxury skincare advertising detail shot

전체 해상도 파일은 4096×4096(최적화 JPEG 약 1.2 MB)이며, 전자상거래 플랫폼 확대 뷰어에서 업스케일링 없이도 선명하게 유지됩니다.
전자상거래 워크로드 비교
아래 모든 가격은 작성 시점 hiapi의 실시간 이미지당 요금입니다 — 현재 수치는 가격 페이지를 확인하세요.
| 모델 | 1K | 2K | 4K | 최적 용도 |
|---|---|---|---|---|
wan2.7-image/text-to-image |
$0.08 | $0.08 | $0.08 | 4K 중심 워크플로, 프롬프트 비중이 높은 구도 |
gpt-image-2/text-to-image |
$0.03 | $0.04 | $0.06 | 1K–2K로 충분한 대량 카탈로그 |
nano-banana |
$0.05 | — | — | 속도(이미지당 1–2초), 빠른 반복 |
nano-banana-pro |
$0.17 | $0.17 | $0.2992 | 하이엔드 브랜드 자산, 다량 텍스트 렌더링 |
저희가 권장하는 의사결정 규칙: 목록에 4K가 필요하다면 Wan 2.7은 제품 라인에서 가장 저렴한 4K 옵션이며, 통일 요금 덕분에 비용 예측이 매우 간단해집니다. 1K–2K로 충분하고 물량이 제한 요소라면 gpt-image-2가 예산 주력입니다. 솔루션을 확정하기 전에 구도를 수십 번 반복해야 한다면 nano-banana의 1–2초 생성이 빠른 반복을 유지해 줍니다 — 그런 다음 승리한 안을 Wan 2.7에서 4K로 다시 렌더링하세요.
완전한 제품 목록 — 메인 이미지, 연출 이미지, 패키징 이미지, 매크로 이미지 — 은 Wan 2.7에서 $0.32가 들며, 작업을 동시에 실행하면 벽시계 시간 5분 미만입니다.
요약
wan2.7-image/text-to-image는 비동기 API 호출 한 번으로 전자상거래 팀에 스튜디오급 제품 사진을 제공합니다: 모든 해상도 최대 4K 통일 $0.08, 구도 요구에 대한 강력한 준수, 패키징 짧은 텍스트의 안정적인 렌더링. 엄격한 가로세로 비율 목록에 주의하고, URL이 만료되기 전에 출력을 다운로드하며, 생성된 텍스트를 교정하세요.
자신의 카탈로그에서 사용해 볼 준비가 되셨나요? API 키를 받고 Wan 2.7 Image Pro 모델 페이지에서 시작하세요. 비동기 API 빠른 시작으로 약 90초 안에 첫 4K 제품 이미지를 렌더링할 수 있습니다.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트