---
title: "z-image-turbo Interface"
method: POST
path: "/v1/images/generations"
tags: ["Image Generation"]
---

# z-image-turbo Interface

`POST /v1/images/generations`

- Z Image Turbo is an ultra-fast text-to-image generation model with exceptional quality
- Asynchronous processing mode, use the returned task ID to [query](/en/api-manual/task-management/get-task-detail)
- Generated image links are valid for 24 hours, please save them promptly

## Request body

- ImageGenerationRequest
  - `model` 'z-image-turbo', required — Image generation model name
  - `prompt` string, required — Prompt describing the image to be generated, limited to 2000 characters
  - `size` '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '9:16' | '16:9' | '1:2' | '2:1' — Size of the generated image. Supports two formats: **Aspect Ratio Format:** - Use preset ratios like `1:1`, `16:9`, `9:16`, etc. - Supported ratios: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16`, `16:9`, `1:2`, `2:1` **Custom Dimensions:** - Width x Height (e.g., `1024x768`) - Width and height range: `376-1536` pixels
  - `seed` integer — Random seed for reproducible results **Note:** - Range: `1` to `2147483647` - Leave empty for random seed - Same seed with same prompt produces similar results
  - `nsfw_check` boolean — Enable additional NSFW content moderation **Note:** - Default: `false` (disabled) - Basic content moderation is always active even when disabled - Enable for stricter content filtering
  - `callback_url` string, uri — HTTPS callback address after task completion **Callback Timing:** - Triggered when task is completed, failed, or cancelled - Sent after billing confirmation is completed **Security Restrictions:** - Only HTTPS protocol is supported - Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - URL length must not exceed `2048` characters **Callback Mechanism:** - Timeout: `10` seconds - Maximum `3` retries on failure (retries after `1` second/`2` seconds/`4` seconds) - Callback response body format is consistent with the task query API response format - Callback address returning 2xx status code is considered successful, other status codes will trigger retry

## Response `200`

Image generation task created successfully

- ImageGenerationResponse
  - `created` integer — Task creation timestamp
  - `id` string — Task ID
  - `model` string — Actual model name used
  - `object` 'image.generation.task' — Specific type of the task
  - `progress` integer — Task progress percentage (0-100)
  - `status` 'pending' | 'processing' | 'completed' | 'failed' — Task status
  - `task_info` TaskInfo
    - `can_cancel` boolean — Whether the task can be cancelled
    - `estimated_time` integer — Estimated completion time (seconds)
  - `type` 'text' | 'image' | 'audio' | 'video' — Output type of the task
  - `usage` Usage — Usage and billing information
    - `billing_rule` 'per_call' | 'per_token' | 'per_second' — Billing rule
    - `credits_reserved` number — Estimated credits to be consumed
    - `user_group` 'default' | 'vip' — User group category

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthenticated, invalid or expired token
- `402` — Insufficient quota, recharge required
- `403` — Access denied
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/evolink/apis/get-credits-usage-api.md) · [All operations](https://skmtc.dev/evolink/apis/get-credits-usage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolink/get-credits-usage-api/revisions/88edb0ec881f/schema)