Alibaba · Image API

Z Image Turbo

z-image-turbo

A speed-focused text-to-image route with flexible aspect ratios and prompt expansion.

POST/v1/images/generations

Output count1–1

Reference imagesNot supported

Resolution tiers1K · 2K

Generation

Generate with Z Image Turbo

Use ImgRouter's unified request contract and this model ID. The example uses recommended defaults from the route's current parameter guide.

cURL

curl https://api.imgrouter.com/v1/images/generations \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: z-image-turbo-generate-001" \
  -d '{
  "model": "z-image-turbo",
  "prompt": "Editorial product photograph, precise materials, soft studio light",
  "size": "1:1",
  "resolution": "1K",
  "n": 1
}'

Request body

modelstring · requiredUse z-image-turbo.

promptstring · requiredGeneration or editing instruction between 1 and 5,000 characters.

sizestringSupported values: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3.

resolutionstringSupported values: 1K, 2K.

ninteger · 1–1Number of output images. Defaults to 1 and cannot exceed 1.

Controls

Supported options

Aspect ratio or size

1:14:33:416:99:163:22:3

Resolution

1K2K

Output format

url

Route notes

Speed-focused text-to-image route with Chinese and English prompt support.

Prompts should stay concise; the route is designed for requests under 800 characters.

Reference images are not supported.

Response

Read the completed output

Successful requests return completed image URLs and a request ID. Store the assets you need permanently; routed output URLs may expire.

200 · application/json

{
  "id": "req_01K4…",
  "object": "image.generation",
  "created": 1787424152,
  "data": [
    { "url": "https://static.imgrouter.com/images/req_01K4.webp" }
  ],
  "usage": { "images": 1 }
}

Use GET /v1/requests/{request_id} for reconciliation and GET /v1/balance for the authenticated key's current Credit position.