创建图片

该接口复用 OpenAI Images Generations 路径，并支持 aspect_ratio 和 resolution 等 Grok 专属参数。

POST/v1/images/generations

根据文本提示创建一张或多张图片。该接口复用 OpenAI 风格的 POST /v1/images/generations 端点，并增加 Grok 图像模型使用的宽高比和分辨率参数。

模型 ID 示例包括 grok-imagine-image-pro 和 grok-imagine-image。请在调用前通过当前 API Key 的模型列表确认实际可用的模型 ID。

单次请求最多生成 10 张图片；URL 返回结果为临时链接，应及时下载或处理；生成内容可能因内容政策被过滤；输出图片通常为 JPG 格式。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Grok 图片生成请求参数。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

用于图像生成的模型 ID。模型示例包括：

grok-imagine-image-pro：进阶图片模型，适合高质量、精细场景。
grok-imagine-image：通用图片生成模型。

实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

期望生成图片的文本描述。

Length1 <= length

n?integer

要生成的图片数量，取值范围为 1 到 10。

Range1 <= value <= 10

Default1

response_format?string

返回生成图片的格式。url 返回临时图片地址，应尽快下载或处理；b64_json 返回 Base64 编码图片数据。

Default"url"

Value in

"url"
"b64_json"

aspect_ratio?string

生成图片的宽高比。不传时由模型自动选择。常用值示例包括：

1:1
16:9、9:16
4:3、3:4
3:2、2:3
2:1、1:2
19.5:9、9:19.5
20:9、9:20
auto

上述值为常用示例，不作为封闭枚举限制。

resolution?string

生成图片的输出分辨率，支持 1k 和 2k。

Value in

"1k"
"2k"

user?string

代表最终用户的唯一标识符，可用于监控与风险控制。

Length1 <= length

Response Body

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A cat in a tree",    "n": 1,    "response_format": "url"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg"
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ]
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`