Z-Image API: 이미지당 $0.008, 실제 출력 결과와 코드

한 줄 요약

• Z-Image는 알리바바 통이(Qwen)에서 출시한 빠른 텍스트-이미지 모델입니다. HiAPI에서 모델 id는 z-image이며, 비용은 이미지당 $0.008: 1,000장은 총 $8입니다.
• 요청에는 두 개의 필드만 포함됩니다: prompt(최대 1,000자)와 aspect_ratio(1:1, 4:3, 3:4, 16:9, 9:16). 크기, 해상도, seed, 이미지 입력은 없습니다.
• 짧은 영어 텍스트가 들어간 사진급 상품 이미지를 잘 생성합니다. 아래 네 가지 테스트에서 모든 텍스트가 정확하게 출력되었습니다. Z-Image 모델 페이지 열기에서 바로 체험해 보세요. 신규 계정은 200개의 무료 크레딧을 받습니다.

가격

이미지 수	z-image 비용
1	$0.008
100	$0.80
600 (상품 200개 × 이미지 3장)	$4.80
1,000	$8.00

HiAPI 실시간 가격, 2026년 10월 20일 조회 기준. 모든 화면 비율 동일 가격. 실패한 작업은 과금되지 않습니다.

HiAPI의 다른 저비용 모델과 비교:

모델	이미지당	이미지 위 텍스트
flux-schnell/text-to-image	$0.005	강점 아님
z-image	$0.008	짧은 영어 텍스트, 테스트에서 안정적으로 정확
qwen-image-2.1-turbo	$0.02	중국어와 영어 지원; 참조 이미지도 입력 가능
gpt-image-2/text-to-image	1K 해상도 기준 $0.03	성능 강력; 이미지 편집도 가능

더 많은 선택지(동영상 포함)는 HiAPI에서 가장 저렴한 이미지 및 동영상 API를 참고하세요.

실제 출력: 텍스트가 포함된 상품 이미지

가격 태그 (1:1)

스튜디오 이커머스 상품 사진: 무광 검정 보온 스테인리스 물병이 이음새 없는 연회색 배경 중앙에 부드러운 그림자와 함께 놓여 있음. 직사각형 코랄색 종이 카드가 물병 옆에 기대어 있음. 카드에는 굵고 깔끔한 산세리프체로 다음 두 줄의 텍스트만 있고 다른 단어는 없음: 첫째 줄 "SUMMER SALE", 둘째 줄 "$19.99". 텍스트는 카메라를 정면으로 향하고 평평하게, 크고 완벽하게 읽을 수 있음. 사진급 사실감.

이 프롬프트로 생성 →

z-image, 1:1, 1536×1536, $0.008.

두 줄의 텍스트가 모두 정확합니다. 카드는 물병 옆에 기대는 대신 결국 물병 손잡이에 걸쳐졌습니다. 이 프롬프트의 첫 버전은 "reads exactly: SUMMER SALE on the first line and $19.99 on the second line"라고 작성되었고, 결과적으로 모델이 두 줄 사이에 "ON"이라는 단어를 하나 더 인쇄했습니다. 정확한 텍스트는 따옴표 안에 넣고, 설명은 따옴표 밖에 작성하세요.

와이드 배너 (16:9)

와이드 이커머스 프로모션 배너, 사실감 있는 플랫레이 사진: 흰색 스니커즈와 크라프트 배송 상자가 파스텔 블루 배경 위에 놓여 있음. 오른쪽에는 굵은 네이비색 산세리프체로 정확히 다음 네 단어와 금액만, 다른 내용 없이: "FREE SHIPPING OVER $50". 이 네 단어가 모두 나타나야 함. 텍스트는 크고 곧게, 완벽하게 읽을 수 있음. 깔끔한 상업용 스튜디오 조명.

이 프롬프트로 생성 →

z-image, 16:9, 1344×768, $0.008.

소셜 미디어 카드 (3:4)

세로형 소셜 미디어 상품 카드: 작은 갈색 유리 화장품 스포이드 병이 따뜻한 베이지색 받침대 위에 놓여 있고 부드러운 자연광. 병 위에는 굵은 검정색 모던 산세리프체 헤드라인 텍스트가 정확히: 30% OFF TODAY ONLY. 텍스트는 카메라를 정면으로 향하고 평평하게, 크고 완벽하게 읽을 수 있음. 미니멀한 프리미엄 이커머스 스타일, 사실감 있는 사진.

이 프롬프트로 생성 →

z-image, 3:4, 928×1232, $0.008.

텍스트는 정확하지만 스포이드가 "ONLY"라는 단어와 겹쳤습니다. 헤드라인이 반드시 선명하게 보여야 한다면 제품 위치를 명시하세요("in the lower half, below the text", 즉 하단 절반, 텍스트 아래).

작은 라벨 텍스트 (3:4)

매크로 이커머스 상품 사진: 깔끔한 흰색 라벨이 있는 무광 유리 스킨케어 병. 라벨 텍스트는 우아한 짙은 색 산세리프체로 인쇄되어 정확히: 첫째 줄 GLOW SERUM, 둘째 줄 VITAMIN C 10%. 정면 평면 각도, 라벨이 완전히 보이고 선명함, 부드러운 스튜디오 조명, 사실감 있는 사진, 흰색 배경.

이 프롬프트로 생성 →

z-image, 3:4, 928×1232, $0.008.

곡면 위의 작은 텍스트는 네 가지 중 가장 어렵지만 출력은 깔끔했습니다. 모델은 "VITAMIN C 10%"를 두 줄로 배치했습니다.

텍스트를 정확하게 출력하는 규칙

1. 정확한 텍스트를 따옴표 안에 넣으세요.
2. "and no other words"(다른 단어 없이)를 추가하세요. 그러면 모델이 불필요한 배지 문구를 만들어내지 않습니다.
3. 텍스트가 카메라를 정면으로 향하고 평평하게 하세요. 기울어지거나 휘어진 텍스트가 가장 먼저 오류가 납니다.
4. 이미지당 텍스트 블록은 하나 또는 두 개만 넣으세요. 더 긴 카피는 나중에 디자인 도구에서 배치하세요.
5. 게시하기 전에 모든 이미지를 확인하세요. $0.008 가격이라면 재생성 비용은 거의 무시할 수 있습니다.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "input": {
      "prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
      "aspect_ratio": "16:9"
    }
  }'

taskId를 받게 됩니다. GET https://api.hiapi.ai/v1/tasks/{taskId}를 호출하여 data.status가 success가 될 때까지 폴링한 후 data.output[0].url을 다운로드하세요. 상태는 queued, handling, archiving을 거쳐 최종적으로 success 또는 fail이 됩니다. 링크는 작업 완료 후 약 7일 뒤 만료됩니다.

Python: 소량 일괄 처리

# pip install requests; 먼저 export HIAPI_KEY=your-key 실행
import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def submit(prompt, ratio="1:1"):
    r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
                      headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)
    return r["data"]["taskId"]

def wait(task_id, timeout_s=300):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] in ("success", "fail"):
            return d
        time.sleep(3)
    raise TimeoutError(task_id)

products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
         for sku, color in products.items()}   # 먼저 모두 제출한 뒤 한꺼번에 수집

for sku, task_id in tasks.items():
    d = wait(task_id)
    if d["status"] == "success":
        with open(f"{sku}.png", "wb") as f:
            f.write(requests.get(d["output"][0]["url"], timeout=120).content)
    else:
        print(sku, "failed:", d.get("error"))

매개변수 및 오류

필드	필수 여부	값
prompt	예	최대 1,000자
aspect_ratio	아니요	1:1, 4:3, 3:4, 16:9, 9:16

다음 경우 제출 시 HTTP 400이 반환되며, 작업이 생성되지 않고 과금도 되지 않습니다:

• additional properties 'size' not allowed(또는 resolution, width): 대신 aspect_ratio를 사용하세요.
• aspect_ratio: value must be one of ...: 21:9 또는 4:5는 지원되지 않습니다. 먼저 16:9 또는 3:4로 생성한 후 자르세요.
• z-image-turbo 같은 모델 id 사용: HiAPI에서 유일한 id는 z-image입니다.

다른 모델로 전환해야 하는 경우

• 기존 이미지 편집이 필요한 경우: Z-Image는 텍스트에서만 생성합니다. 이미지-투-이미지 모델을 사용하세요. 예: qwen-image-2.1-turbo($0.02) 또는 gpt-image-2/image-to-image.
• 텍스트가 길거나 밀집되어 있거나 중국어가 많은 경우: Qwen Image를 사용해 보세요. 이중 언어 조판에 특화되어 있습니다.
• 최저 가격을 추구하고 텍스트가 필요 없는 경우: flux-schnell/text-to-image는 $0.005입니다.

자주 묻는 질문

모델 id는 무엇인가요?

z-image. HiAPI에는 별도의 z-image-turbo id가 없습니다. Turbo는 이 빠른 변형이 업스트림에서 불리는 이름입니다.

API 키는 어떻게 얻나요?

hiapi.ai에서 가입하고 콘솔에서 키를 생성한 후 Authorization: Bearer <key>로 전송하세요. 동일한 키가 모든 모델에 적용됩니다.

중국어 텍스트를 렌더링할 수 있나요?

알리바바는 이중 언어 텍스트를 강점으로 내세웁니다. 위 네 가지 테스트는 모두 영어였으므로, 의존하기 전에 자신의 프롬프트로 중국어 출력을 먼저 확인하세요.

해상도 설정이 있나요?

없습니다. 출력 크기는 화면 비율에 따라 결정됩니다: 위 테스트에서 1:1은 1536×1536, 16:9는 1344×768, 3:4는 928×1232를 반환했습니다.

코딩 없이 프롬프트를 시험해 보고 싶다면? Z-Image 모델 페이지 열기.