z-image-turbo - Generate Image (AI Model · By )

API Documentation

API Reference

Images

Generate Image

Supported Model Code

Loading models...

z-image-turbo

z-image-turbo0 models support this endpoint

Z-Image-Turbo is a highly efficient image generation model that ranks first among open-source text-to-image models worldwide in Artificial Analysis benchmarks. With only 6 billion parameters and 8 inference steps, it can generate photorealistic images comparable to large-scale commercial models. It also demonstrates outstanding performance in bilingual (Chinese and English) text rendering, complex semantic understanding, and diverse thematic generation.

Generate image

https://api.modelstream.ai

POST/v1/images/generations

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

prompt*string

Describe the content, style, and composition of the image. Supports English and Chinese, max 800 chars.

RequiredExample Value: Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza. Daylight evenly illuminates the scene. Full-body portrait, centered composition, high detail, sharp focus.Placeholder: Enter prompt...

size?string

Image resolution in 'width*height' format. Total pixels must be within [512*512, 2048*2048]; [1024*1024, 1536*1536] is recommended for best quality. Default 1024*1536.

Example Value: 1024*1536

Enum/Options:

2:3: 1024*15361:1: 1024*10243:2: 1536*10243:4: 864*11524:3: 1152*8649:16: 720*128016:9: 1280*720

prompt_extend?boolean

When enabled, an LLM intelligently rewrites and optimizes your prompt to improve results (slightly higher cost). Disabled by default.

Example Value: false

seed?number

Random seed, range [0, 2147483647]. The same prompt with the same seed yields similar results. Leave empty for random.

Placeholder: Leave empty for random seed

Response Parameters

application/json

200apiDocs.responses.successGenerateImage

created?integer

Parameter description for Created

data?array

Parameter description for Data

curl -X POST "https://api.modelstream.ai/v1/images/generations" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image-turbo",
  "prompt": "Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza. Daylight evenly illuminates the scene. Full-body portrait, centered composition, high detail, sharp focus.",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza. Daylight evenly illuminates the scene. Full-body portrait, centered composition, high detail, sharp focus."
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "1024*1536",
    "prompt_extend": false
  }
}'

{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}

API Documentation

API Reference

Images

Generate Image

Supported Model Code

Loading models...

z-image-turbo

z-image-turbo0 models support this endpoint

Generate image

https://api.modelstream.ai

POST/v1/images/generations

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

prompt*string

Describe the content, style, and composition of the image. Supports English and Chinese, max 800 chars.

size?string

Image resolution in 'width*height' format. Total pixels must be within [512*512, 2048*2048]; [1024*1024, 1536*1536] is recommended for best quality. Default 1024*1536.

Example Value: 1024*1536

Enum/Options:

2:3: 1024*15361:1: 1024*10243:2: 1536*10243:4: 864*11524:3: 1152*8649:16: 720*128016:9: 1280*720

prompt_extend?boolean

When enabled, an LLM intelligently rewrites and optimizes your prompt to improve results (slightly higher cost). Disabled by default.

Example Value: false

seed?number

Random seed, range [0, 2147483647]. The same prompt with the same seed yields similar results. Leave empty for random.

Placeholder: Leave empty for random seed

Response Parameters

application/json

200apiDocs.responses.successGenerateImage

created?integer

Parameter description for Created

data?array

Parameter description for Data

curl -X POST "https://api.modelstream.ai/v1/images/generations" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image-turbo",
  "prompt": "Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza. Daylight evenly illuminates the scene. Full-body portrait, centered composition, high detail, sharp focus.",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza. Daylight evenly illuminates the scene. Full-body portrait, centered composition, high detail, sharp focus."
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "1024*1536",
    "prompt_extend": false
  }
}'

{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}