---
title: "图像生成(异步)"
method: POST
path: "/paas/v4/async/images/generations"
tags: ["模型 API"]
---

# 图像生成(异步)

`POST /paas/v4/async/images/generations`

使用 [GLM-Image](/cn/guide/models/image-generation/glm-image) 系列模型从文本提示生成高质量图像。通过对用户文字描述快速、精准的理解，让 `AI` 的图像表达更加精确和个性化。仅支持 `GLM-Image` 模型。点击 **Try it** 按钮可快速试用。

## Request body

- AsyncCreateImageRequest
  - `model` 'glm-image', required — 模型编码
  - `prompt` string, required — 所需图像的文本描述
  - `quality` 'hd' — 生成图像的质量。`hd`: 生成更精细、细节更丰富的图像，整体一致性更高，耗时约`20`秒；
  - `size` string — 图片尺寸，推荐枚举值：`1280x1280` (默认), `1568×1056`, `1056×1568`, `1472×1088`, `1088×1472`, `1728×960`, `960×1728`。 自定义参数:长宽推荐设置在`1024px-2048px`范围内,并保证最大像素数不超过`2^22px`;长宽均需为`32`的整数倍。
  - `watermark_enabled` boolean — 控制`AI`生成图片时是否添加水印。 - `true`: 默认启用`AI`生成的显式水印及隐式数字水印，符合政策要求。 - `false`: 关闭所有水印，仅允许已签署免责声明的客户使用，签署路径：个人中心-安全管理-去水印管理
  - `user_id` string — 终端用户的唯一`ID`，协助平台对终端用户的违规行为、生成违法及不良信息或其他滥用行为进行干预。`ID`长度要求：最少`6`个字符，最多`128`个字符。

## Response `200`

业务处理成功

- AsyncResponse
  - `model` string — 此次调用使用的名称。
  - `id` string — 生成的任务`ID`，调用请求结果接口时使用此`ID`。
  - `request_id` string — 用户在客户端请求期间提交的任务编号或平台生成的任务编号。
  - `task_status` string — 处理状态，`PROCESSING (处理中)`、`SUCCESS (成功)`、`FAIL (失败)`。结果需要通过查询获取。

## Other responses

- `default` — 请求失败。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)