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

# 图像生成

`POST /paas/v4/images/generations`

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

## Request body

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

## Response `200`

业务处理成功

- ImageGenerationResponse
  - `created` integer — 请求创建时间，是以秒为单位的`Unix`时间戳
  - `data` object[] — 数组，包含生成的图片`URL`。目前数组中只包含一张图片。
    - `url` string, required — 图片链接。图片的临时链接有效期为`30`天，请及时转存图片。
  - `content_filter` object[] — 返回内容安全的相关信息
    - `role` 'assistant' | 'user' | 'history' — 安全生效环节，包括 `role = assistant` 模型推理，`role = user` 用户输入，`role = history` 历史上下文
    - `level` integer — 严重程度 `level 0-3`，`level 0`表示最严重，`3`表示轻微

## 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)