v1.0.0안정 버전

Z Image Turbo API

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

퀵 스타트

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

작업 제출

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

상태 조회

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

인증

HTTP 헤더

Authorization: Bearer {YOUR_API_KEY}

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

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.

{
  "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": "xxx",
      "size": "1024*1024",
      "seed": "-1"
    },
    "response": [
      "https://xxx.com/sample.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 — 6B-parameter, ultra-fast text-to-image

Z-Image-Turbo is a 6B-parameter text-to-image model from Tongyi-MAI, engineered for production workloads where latency and throughput really matter. It uses only 8 sampling steps to render a full image, achieving sub-second latency on data-center GPUs and running comfortably on many 16 GB VRAM consumer cards.

Ultra-fast generation with production-ready quality

Where many diffusion models need dozens of steps, Z-Image-Turbo is aggressively optimised around an 8-step sampler. That keeps inference extremely fast while still delivering photorealistic images and reliable on-image text, making it a strong fit for interactive products, dashboards, and large-scale backends—not just offline batch jobs.

Why it looks so good?

• Photorealistic output at speed — Generates high-fidelity, realistic images that work for product photos, hero banners, and UI visuals without multi-second waits.
• Bilingual prompts and text — Understands prompts in English and Chinese, and can render multilingual text directly in the image—helpful for cross-market campaigns, posters, and screenshots.
• Low-latency, low-step design — Only 8 function evaluations per image deliver extremely low latency, ideal for chatbots, configuration tools, design assistants, and any “click → image” experience.
• Friendly VRAM footprint — Runs well in 16 GB VRAM environments, reducing hardware costs and making local or edge deployments more realistic.
• Scales for bulk generation — Its efficiency makes large jobs—catalogues, continuous feed images, or auto-generated thumbnails—practical without blowing up compute budgets.
• Reproducible generations — A controllable seed parameter lets you recreate a previous image or generate small, controlled variations for brand safety and experimentation.

How to use

prompt – natural-language description of the scene, style, and any on-image text (English or Chinese).
size (width / height) – choose the output resolution; supports square and rectangular images up to high resolutions (for example, 1536 × 1536).
seed – set to -1 for random results, or use a fixed integer to make outputs reproducible.