Справочникv1.0.0 Стабильно

Z Image Turbo API

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

https://zimageturbo.ai

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

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

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

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

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

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

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

Важно: храните свой API Key в безопасности и не раскрывайте его в клиентском коде.

HTTP Header

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

О Z Image Turbo

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

Z-Image-Turbo — 6B параметров, сверхбыстрая генерация

Z-Image-Turbo — 6-миллиардная модель text-to-image от Tongyi-MAI, созданная для задач с низкой задержкой.

Скорость и качество

Модель использует только 8 шагов выборки, обеспечивая высокую скорость и фотореалистичное качество.

Почему качество такое высокое?

Фотореалистичные изображения — подходит для продуктов, баннеров, UI.
Понимает китайский и английский — может генерировать текст на изображении.
Низкая задержка — отлично для чат-инструментов и конфигураторов.
Низкие требования VRAM — работает на 16 GB GPU.
Массовая генерация — рентабельно для каталогов и потоковых задач.
Воспроизводимость — контроль seed для повторного результата.

Как использовать

promptprompt – описание сцены, стиля и текста.
sizesize – установите разрешение изображения.
seedseed – -1 случайно, или используйте фиксированное значение.

Z-Image-Edit Prompts