grok-imagine-image-quality 将于 2026 年 11 月 2 日停用

grok-imagine-image（1.0）不受此次变更影响。

重定向的工作方式

自 2026 年 11 月 2 日起：

• 发送给 grok-imagine-image-quality 的请求，在 /v1/images/generations 和 /v1/images/edits 上将由 grok-imagine-image-2.0 处理，且使用 quality: "low"。

• 请求和响应结构不变。当前接受的所有参数在切换后仍可使用；此外，grok-imagine-image-2.0 还接受 quality 参数、最多五张编辑源图，以及 21:9 和 5:2 宽高比。

• 响应中的 model 字段会报告实际处理请求的模型，因此你可以通过日志确认切换情况。

• 对 grok-imagine-image-pro 的请求已经重定向至 grok-imagine-image-quality，之后也会随之转到 grok-imagine-image-2.0，使用 low 质量。

对价格的影响

在所有分辨率下，grok-imagine-image-2.0 的 low 质量均比 grok-imagine-image-quality 每张便宜 $0.01。如果你在 11 月 2 日之后继续向已停用的模型标识发送请求，将按 grok-imagine-image-2.0 的 low 费率计费。当前每张图像的费率请参阅价格。

推荐替代模型

建议在 11 月 2 日之前显式切换到 grok-imagine-image-2.0。这样你可以自行选择付费使用的质量，而非接受重定向所应用的默认 low 质量。

迁移只需修改一行 model 字段。grok-imagine-image-2.0 还接受可选的 quality 参数：

• low 是重定向使用的质量。它在 Arena 图像编辑排行榜排名第 2，在文生图排行榜排名第 3，成本也最接近 grok-imagine-image-quality。

• medium 为每张图像投入更多计算资源，以生成更精细的细节；当输出质量比成本更重要时可选择此项。

• auto（省略 quality 时的默认值）目前在生成图像时使用 low，编辑图像时使用 medium，并按实际提供的质量计费。

import xai_sdk

client = xai_sdk.Client()

response = client.image.sample(
    prompt="A watercolor painting of a lighthouse at dawn",
    model="grok-imagine-image-2.0",
    quality="low",
)

print(response.url)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.x.ai/v1",
    api_key="YOUR_API_KEY",
)

response = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="A watercolor painting of a lighthouse at dawn",
    extra_body={"quality": "low"},
)

print(response.data[0].url)

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: process.env.XAI_API_KEY,
    baseURL: "https://api.x.ai/v1",
});

const response = await client.images.generate({
    model: "grok-imagine-image-2.0",
    prompt: "A watercolor painting of a lighthouse at dawn",
    quality: "low",
});

console.log(response.data[0].url);

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A watercolor painting of a lighthouse at dawn",
    "quality": "low"
  }'

同样的 model 修改也适用于图像编辑请求，其端点为 /v1/images/edits。

需要帮助？

如果你对此次迁移有疑问或需要帮助，请联系 support@x.ai。