外观
Grok 生图
不想对接 API？直接使用知梦画布
如果你只是想直接生图，可以打开 知梦画布。在密钥配置中选择 「聚合模型」 分组，填写你的知梦 API 密钥后即可开始生成图片，无需自己编写接口代码。
知梦 Grok 生图按照 xAI 官方生图协议调用。接入时只需要替换 Base URL、API Key 和使用知梦当前开放的模型 ID，请求路径、JSON 字段以及返回结构均按 Grok Imagine 图片接口组织。
快速信息
| 项目 | 内容 |
|---|---|
| REST Base URL | https://api.zmoapi.cn |
| SDK Base URL | https://api.zmoapi.cn/v1 |
| 模型 ID | grok-imagine-image / grok-imagine-image-2.0 |
| 支持分辨率 | 1k / 2k |
| 质量参数 | 仅 grok-imagine-image-2.0 支持 auto / low / medium |
| 单价 | 两个模型均为 ¥0.1 / 张 |
| 文生图 | POST /v1/images/generations |
| 图片编辑 | POST /v1/images/edits |
| 请求格式 | application/json |
| 默认返回 | data[].url |
支持能力
这两个模型是彼此独立的模型，不是同一个模型的清晰度档位。接入前请进入对应模型页面确认能力和参数：
| 模型 | 主要能力 | 详情 |
|---|---|---|
grok-imagine-image | 文生图、单张参考图编辑；不支持 quality | 查看模型文档 |
grok-imagine-image-2.0 | 文生图、最多 5 张参考图编辑；支持 quality | 查看模型文档 |
两者均可通过 resolution 选择 1k 或 2k，一次生成 1–10 张图片，并可返回临时图片 URL 或 Base64。
最短文生图示例
bash
curl 'https://api.zmoapi.cn/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data-raw '{
"model": "grok-imagine-image",
"prompt": "一座建在云海之上的未来城市，清晨阳光，电影感构图",
"aspect_ratio": "16:9",
"resolution": "1k",
"n": 1,
"response_format": "url"
}'成功后从以下位置读取图片：
text
data[].url图片编辑与参考图
Grok 图片编辑使用 JSON 请求，而不是 multipart 文件上传：
http
POST /v1/images/edits
Content-Type: application/json单张参考图放在 image，多张参考图放在 images。本地文件需要先转换为 Base64 Data URI。
不要使用 OpenAI SDK 的 images.edit()
OpenAI SDK 的 images.edit() 会构造 multipart/form-data，与 Grok 官方图片编辑协议不一致。图片编辑请使用 fetch、requests 或其他能够发送 JSON 的 HTTP 客户端。