v1.0.0Стабильно

Z Image Turbo API

Интегрируйте высокопроизводительную генерацию изображений на базе AI. Документация предоставляет полное описание API, примеры кода и руководство по интеграции.

Быстрый старт

Только два шага до первого вызова API: отправьте задачу и затем запрашивайте статус.

Отправить задачу

Отправьте POST запрос на generate и получите Task ID.

Проверить статус

Используйте Task ID для проверки прогресса, пока не получите URL изображения.

Аутентификация

HTTP Header

Authorization: Bearer {YOUR_API_KEY}

Важно: храните свой 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.

{
  "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 Key
402 Payment RequiredНедостаточно средств
429 Too Many RequestsПревышен лимит запросов

О Z Image Turbo

Z Image Turbo — движок генерации изображений, оптимизированный на основе современных диффузионных моделей. Ускорение до 300% без потери качества — идеально подходит для игр, e-commerce и интерактивных приложений.

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.