原生透传层

生成图片

给一段文字描述，直接拿到图片。请求体原样转发给 Grok，不做转换、不做本地补全，报错是官方原文。

POST/xai/v1/images/generations

端点

http

POST /xai/v1/images/generations

这是 原生透传路径：请求体原样转发给 Grok，字段名必须和 xAI 官方文档完全一致。

同一能力在 OpenAI 兼容层的写法见生成图片（OpenAI 兼容）。

请求

bash

curl -X POST https://api.wxiai.com/xai/v1/images/generations \
  -H "Authorization: Bearer $WXIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "一只戴着宇航头盔的柴犬，扁平插画风格，纯色背景",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }'

为什么推荐原生透传：Grok 上线新参数（比如新的 resolution 档位）你当天就能用；报错也是官方原文。

请求参数

参数	必填	说明
`model`	是	图像模型，如 `grok-imagine-image-2.0`
`prompt`	是	画面描述
`n`	否	生成张数，1–10，默认 `1`。按张计费
`aspect_ratio`	否	画面比例，默认 `auto`（模型自选）。全部取值见总览
`resolution`	否	`1k`（默认）/ `2k`
`quality`	否	`low` / `medium` / `auto`（默认）。只对 `grok-imagine-image-2.0` 生效
`response_format`	否	`url`（默认）或 `b64_json`
`storage_options`	否	把产物存入 xAI 文件服务，见总览
`user`	否	你自己终端用户的标识，用于滥用监测

原生路径不认 size

原生路径不做任何字段换算，写 size: "1024x1024" 只会被原样丢给 Grok。

支持的尺寸字段只有官方这一对：resolution（"1k" / "2k"）+ aspect_ratio。

`quality` 的真实语义

默认 auto 时：文生图按 low 出图，图像编辑按 medium 出图；计费按实际服务的档位算。想固定档位就显式传 low 或 medium。

json

{
  "data": [
    {
      "url": "https://imgen.x.ai/.../image.jpg",
      "mime_type": "image/jpeg"
    }
  ],
  "usage": {
    "cost_in_usd_ticks": 400000000
  }
}

字段	说明
`data[].url`	图片地址。`response_format` 为 `url`（默认）时有
`data[].b64_json`	base64 图片数据（不含 `data:` 前缀）。`response_format` 为 `b64_json` 时有
`data[].mime_type`	图片格式，如 `image/png`、`image/jpeg`、`image/webp`
`usage.cost_in_usd_ticks`	本次请求成本，单位是「USD tick」：1 美分 = 100,000,000 ticks
`usage.input_tokens` / `output_tokens` / `total_tokens`	`grok-imagine-image-2.0` 按张计费，不返回 token 字段。只有按 token 计费的图像模型才会有

这一层的注意点

resolution 不是 1024x1024：Grok 只认 1k / 2k 两档。
url 是临时地址：拿到后尽快下载转存。用 storage_options 可以让上游长期保存。
超时按对话接口设：出图要几十秒，客户端超时调到 120 秒以上。
传了不支持的字段不会本地报错：原生层不做校验，错误由 Grok 返回，所以看清官方原文。

生成图片

端点 ​

请求 ​

请求参数 ​

quality 的真实语义 ​

返回 ​

这一层的注意点 ​

相关页 ​

端点

请求

请求参数

`quality` 的真实语义

返回

这一层的注意点

相关页