Z Image Turbo API 연동 방법: 저비용 이미지 생성($0.0036/장) 프로덕션 가이드

이 가이드는 철저히 객관적이며 구현 중심으로 작성되었습니다. 다음 내용을 배우게 됩니다:

• ZImage Turbo가 무엇이며 주요 기능은 무엇인지
• EvoLink의 ZImage 엔드포인트 작동 방식(비동기 작업 + 웹훅 규칙)
• 비용 제어 및 운영 가드레일을 고려한 ZImage Turbo 연동 방법
• ZImage를 기본값으로 사용하기에 적합한 경우와 그렇지 않은 경우

1. ZImage Turbo란 무엇인가

• 높은 시각적 충실도를 갖춘 실사 이미지 생성
• 생성된 이미지 내 직접적인 이국어(중/영) 텍스트 렌더링
• 대량 생산에 적합한 빠른 추론 속도
• 일관되고 예측 가능한 결과물을 위한 지시어 이행 능력

ZImage Turbo 시각적 품질 예시 A	ZImage Turbo 시각적 품질 예시 B

2. ZImage 가격 컨텍스트: 공개 가격표와 비교

• EvoLink의 모델 카탈로그에는 ZImage Turbo가 이미지당 $0.0036부터 시작하는 것으로 기재되어 있으며, '시장' 참조가는 $0.0050으로 표시됩니다.
• EvoLink의 변경 로그에서도 ZImage Turbo 가격을 ~$0.0036/이미지로 언급하고 있습니다.
• fal.ai의 가격 페이지에는 널리 사용되는 여러 호스팅 이미지 모델들이 이미지당 약 $0.03–$0.04(모델별 상이)로 표시되어 있습니다.
• fal.ai는 또한 Z-Image Turbo 가격을 **$0.005/MP(Megapixel)**로 기재하고 있습니다(ZImage 자체의 시장 참조가로 유용함).

비용 비교표 (투명한 가정 기반)

가정: '이미지 1만 장'은 약 1MP 크기(예: 1024×1024 ≈ 1MP)의 결과물 10,000개를 생성하는 것을 의미합니다. 정확한 플랜과 출력 크기에 따른 과금 규칙을 항상 확인하십시오.

3. EvoLink ZImage Turbo API 작동 방식 (비동기 설계)

1. POST /v1/images/generations로 ZImage 생성 요청을 전송합니다.
2. 즉시 **작업 ID(task ID)**를 받습니다.
3. GET /v1/tasks/{task_id}를 통해 작업 상태를 쿼리하거나 웹훅 콜백을 사용합니다.

4. ZImage Turbo 빠른 시작 (복사/붙여넣기)

4.1 ZImage 생성 작업 생성

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "z-image-turbo",
  "prompt": "A clean product hero shot, studio lighting, soft shadow, minimal background, no watermark",
  "size": "1:1"
}
'

{
  "id": "task_abc123",
  "status": "pending",
  "model": "z-image-turbo",
  "progress": 0,
  "created": 1735100000,
  "task_info": {
    "can_cancel": true,
    "estimated_time": 10
  },
  "usage": {
    "credits_reserved": 1
  }
}

4.2 ZImage 작업 상태 쿼리

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <YOUR_TOKEN>'

5. ZImage Turbo 파라미터

• prompt: 필수, 최대 2000자.
• size: 비율(1:1, 16:9 등) 또는 사용자 정의 규격(376x376 ~ 1536x1536) 지원.
• seed: 재현성을 위한 정수(1 - 2147483647).
• callback_url: 비동기 알림을 위한 HTTPS URL.

6. ZImage 웹훅: 콜백 규칙

• HTTPS 전용: 내부 IP는 허용되지 않음.
• 재시도: 최대 3회 재시도(1초, 2초, 4초 간격).
• 형식: 콜백 바디는 작업 조회 API 응답 형식과 일치함.

7. ZImage 프로덕션 패턴

• 패턴 A: 변체 선택: 4~8개의 후보를 저렴하게 생성하고 최적의 결과물을 선택함.
• 패턴 B: 즉시 영구 저장: 출력물을 사용자 S3/OSS에 즉시 저장함(URL은 24시간 후 만료).
• 패턴 C: 워커 큐: 상태 폴링 또는 웹훅 처리를 위해 분리된 워커를 사용함.

8. ZImage 프롬프트 템플릿

템플릿: 이국어 포스터 드래프트

프롬프트: 명확한 이국어 타이포그래피가 포함된 깔끔한 소매 포스터 레이아웃. 큰 제목: "Winter Sale" 및 "冬季大促". 부제목: "Up to 50% off" 및 "最高立减50%". 현대적인 그리드 레이아웃, 높은 대비, 산세리프체.

9. 의사 결정 매트릭스

10. FAQ

• 아키텍처: 6B 모델, S3-DiT 아키텍처, Turbo용 8 NFE.
• 보존 기간: 링크는 24시간 동안 유효함.
• 가격: EvoLink.ai에서 $0.0036부터 시작.

결론