Skip to main content
POST
/
paas
/
v4
/
images
/
generations
Generate Image
curl --request POST \
  --url https://api.z.ai/api/paas/v4/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "glm-image",
  "prompt": "A cute little kitten sitting on a sunny windowsill, with the background of blue sky and white clouds.",
  "size": "1280x1280"
}
'
{
  "created": 1760335349,
  "data": [
    {
      "url": "<string>"
    }
  ],
  "content_filter": [
    {
      "role": "assistant",
      "level": 1
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Use the following format for authentication: Bearer

Body

application/json
​
model
enum<string>
required

Model code

Available options:
glm-image,
cogview-4-250304
Example:

"glm-image"

​
prompt
string
required

The text description of the image to be generated.

Example:

"A cute little kitten."

​
quality
enum<string>
default:hd

The quality of the generated image. glm-image default is hd, others model is standard. hd: Generates a more detailed and rich image with higher overall consistency, but takes about 20 seconds. standard: Generates an image quickly, suitable for scenarios with higher requirements for generation speed, takes about 5-10 seconds.

Available options:
hd,
standard
​
size
string
default:1280x1280

Image size. glm-image recommended enum values: 1280x1280 (default), 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728. Custom parameter: Both width and height must be between 1024px-2048px, and must be divisible by 32, and the maximum pixel count must not exceed 2^22px. Others model recommended enum values: 1024x1024 (default), 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440. Custom parameter: Both width and height must be between 512px-2048px, and must be divisible by 16, and the maximum pixel count must not exceed 2^21px.

Example:

"1280x1280"

​
user_id
string

Unique ID of the end user, helping the platform intervene in illegal activities, inappropriate content generation, or other abuses. ID length: 6 to 128 characters.

Required string length: 6 - 128

Response

Processing successful

​
created
integer

Request creation time, in Unix timestamp format, unit is seconds.

Example:

1760335349

​
data
object[]

Array, containing the generated image URL. Currently, the array only contains one image.

​
content_filter
object[]

Array, containing content safety related information.