Z Image Turbo API
고성능 AI 이미지 생성 기능을 서비스에 통합할 수 있습니다. 이 문서는 완전한 API 레퍼런스, 연동 가이드, 코드 예제를 제공하여 개발자가 빠르게 AI 이미지 애플리케이션을 구축할 수 있도록 돕습니다.
퀵 스타트
생성 작업을 제출하고 상태를 폴링하는 두 단계만으로 첫 번째 API 호출을 완료할 수 있습니다.
작업 제출
POST 요청을 generate 엔드포인트로 보내 Task ID를 받습니다.
상태 조회
Task ID를 사용해 진행 상황을 확인하고, 이미지 URL이 반환될 때까지 조회합니다.
인증
Authorization: Bearer {YOUR_API_KEY}주의: API 키는 안전하게 보관하고, 클라이언트 사이드 코드에 노출하지 마세요.
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.
본문 파라미터
| 파라미터 이름 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| 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"
}
}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
}
}결제
요청당 비용
실패한 작업에는 비용이 청구되지 않습니다.
오류 처리
- 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.