레퍼런스v1.0.0 안정 버전

Z Image Turbo API

고성능 AI 이미지 생성 기능을 서비스에 통합할 수 있습니다. 이 문서는 완전한 API 레퍼런스, 연동 가이드, 코드 예제를 제공하여 개발자가 빠르게 AI 이미지 애플리케이션을 구축할 수 있도록 돕습니다.

https://zimageturbo.ai

퀵 스타트

생성 작업을 제출하고 상태를 폴링하는 두 단계만으로 첫 번째 API 호출을 완료할 수 있습니다.

작업 제출

POST 요청을 generate 엔드포인트로 보내 Task ID를 받습니다.

상태 조회

Task ID를 사용해 진행 상황을 확인하고, 이미지 URL이 반환될 때까지 조회합니다.

인증

주의: API 키는 안전하게 보관하고, 클라이언트 사이드 코드에 노출하지 마세요.

HTTP 헤더

Authorization: Bearer {YOUR_API_KEY}

POST

https://zimageturbo.ai/api/generate

Create a new image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the final images.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

본문 파라미터

파라미터 이름	타입	필수 여부	설명
`prompt`	string	필수	Text prompt for generation (max 1000 characters).
`aspect_ratio`	string	필수	Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.

응답(JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://zimageturbo.ai/api/status

작업의 실행 상태와 결과를 조회합니다.

쿼리 파라미터

파라미터 이름	필수 여부	설명
`task_id`	필수	작업을 제출할 때 반환된 ID입니다.

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

결제

요청당 비용

$0.02 / 요청

실패한 작업에는 비용이 청구되지 않습니다.

오류 처리

401 Unauthorized유효하지 않은 API 키입니다.
402 Payment Required잔액이 부족합니다.
429 Too Many Requests요청 한도에 도달했습니다.

Z Image Turbo 소개

Z Image Turbo는 최신 확산(디퓨전) 모델을 기반으로 최적화된 이미지 생성 엔진입니다. 추론 속도를 기존 모델의 300% 수준까지 끌어올리면서도 매우 높은 화질을 유지하는 데 초점을 맞추고 있습니다. 실시간 인터랙션, 게임 에셋 생성, 이커머스 디자인 등의 시나리오에 적합합니다.

Z-Image-Turbo — 60억 파라미터의 초고속 텍스트-투-이미지 모델

Z-Image-Turbo는 Tongyi-MAI에서 개발한 60억 파라미터 텍스트-투-이미지 모델로, 레이턴시와 처리량이 중요한 프로덕션 워크로드에 맞춰 설계되었습니다. 단 8 스텝 샘플링만으로 전체 이미지를 렌더링하며, 데이터센터 GPU에서 1초 미만의 지연을 달성하고, 많은 16 GB VRAM 소비자용 카드에서도 안정적으로 동작합니다.

프로덕션 품질의 초고속 이미지 생성

많은 확산 모델이 수십 스텝을 필요로 하는 반면, Z-Image-Turbo는 8스텝 샘플러에 공격적으로 최적화되어 있습니다. 이를 통해 매우 빠른 추론 속도를 유지하면서도 포토리얼 이미지와 신뢰할 수 있는 온이미지 텍스트를 제공하여, 대시보드, 인터랙티브 제품, 대규모 백엔드 등 배치 작업뿐 아니라 다양한 실시간 서비스에도 적합합니다.

왜 이렇게 잘 나올까요?

속도와 포토리얼리즘 동시 제공 — 여러 초를 기다릴 필요 없이, 상품 사진, 히어로 배너, UI 비주얼 등에 사용할 수 있는 고품질·고해상도 이미지를 생성합니다.
이중언어 프롬프트와 텍스트 — 영어와 중국어 프롬프트를 이해하고, 이미지 안에 다국어 텍스트를 직접 렌더링할 수 있어, 크로스 마켓 캠페인, 포스터, 스크린샷에 유용합니다.
저지연·저스텝 구조 — 이미지당 8번의 함수 평가만으로 매우 낮은 지연을 제공하여, 챗봇, 구성 도구, 디자인 어시스턴트 등 ‘클릭 → 이미지’ 경험에 최적입니다.
VRAM 친화적인 메모리 사용 — 16 GB VRAM 환경에서도 원활하게 실행되며, 로컬 또는 엣지 배포를 보다 현실적인 옵션으로 만듭니다.
대량 생성에 최적화 — 높은 효율 덕분에 카탈로그, 지속 피드 이미지, 자동 생성 썸네일 등 대규모 작업도 컴퓨트 예산을 크게 늘리지 않고 실행할 수 있습니다.
재현 가능한 생성 — 제어 가능한 seed 파라미터를 통해 이전 이미지를 다시 생성하거나, 브랜드 세이프티와 실험을 위한 작은 변형 이미지를 만들 수 있습니다.

사용 방법

promptprompt – 장면, 스타일, 이미지 안의 텍스트(영어 또는 중국어)를 포함한 자연어 설명입니다.
sizesize (가로 / 세로) – 출력 해상도를 선택합니다. 1536×1536과 같은 고해상도 정사각형·직사각형 이미지를 지원합니다.
seedseed – 무작위 결과가 필요하면 -1로 설정하고, 동일한 출력을 다시 얻고 싶다면 고정된 정수 값을 사용하세요.

Z-Image-Edit Prompts