grok-imagine-image-2.0 构建文生图和图像编辑工作流。xAI API 通过兼容 OpenAI 的图像端点支持可配置的画面比例、分辨率、输出数量和响应格式。用于 Imagine Image 2.0 的 Grok API
使用
创建 xAI API 密钥
选择合适的 Grok 图像工作流
发送生产环境请求前,先验证媒体输入和输出设置。
Grok Imagine Image 2.0 API 功能
专用图像模型
将
model 设置为 grok-imagine-image-2.0,用于当前的 Imagine Image 2.0 生成和编辑。文生图生成
向
/v1/images/generations 发送提示词,并一次请求最多生成 10 张图像。可配置输出
选择画面比例、1K 或 2K 分辨率、输出数量以及受支持的响应格式。
图像编辑
向
/v1/images/edits 发送编辑指令,并附上公开图像 URL 或 base64 编码的数据 URI。最多三个编辑参考图
多图编辑最多接受三张源图像,用于构图、主体组合和风格引导。
Bearer 认证
在
Authorization 请求头中发送 xAI API 密钥,并确保凭据不进入浏览器代码、日志和代码仓库。xAI 采用每张图片固定单价,分辨率和质量会影响输出费用。
Grok API 的 Imagine Image 2.0 定价
生成输出价格
xAI 目前列出的 Imagine Image 2.0 输出价格为:1K Low 每张 $0.04,2K Low 每张 $0.06,1K Medium 每张 $0.06,2K Medium 每张 $0.08。
媒体输入价格
Imagine Image 2.0 路由的图像输入定价为每张输入图像 $0.01;因此编辑操作包含输入图像和生成输出的费用。
提示词长度不决定图像费用
图像生成采用固定单价(按张计费),而非基于 token 的提示词计费。将你请求的图像数量乘以所选输出档位单价,再加上编辑时的图像输入费用即可。
复查实时定价
在上生产环境前,先查看 xAI 当前定价页面,因为模型档位和计费条款可能变化。
集成 Grok 图像 API
1
1. 创建并妥善保管 API Key
在 xAI 控制台创建密钥,并以
Authorization: Bearer $XAI_API_KEY 的形式发送。请将密钥保存在服务端。 2
2. 选择生成或编辑
仅使用提示词创建时,调用
/v1/images/generations;当需要以源图作为引导或对源图进行变换时,调用 /v1/images/edits。 3
3. 构建经过校验的请求
将
model 设为 grok-imagine-image-2.0,添加提示词,并只显式选择你的产品支持的输出选项。 4
4. 提交并检查响应
在持久化返回的 URL 或 base64 数据之前,先检查 HTTP 状态和响应体。不要假设每个响应都包含可用图片。
5
5. 有意识地下载并保留资源
当需要长期可用时,将已生成的资源复制到你自己批准的存储中,并以幂等方式处理重试,避免重复计费。
当可重复的提示词和编辑工作流比手动图像编辑器更重要时,请使用此 API。
开发者用 Grok Imagine Image 2.0 构建什么
营销活动创意变体
通过结构化提示词模板,为广告、落地页和社交媒体活动生成多种视觉方向。
产品与概念可视化
将产品简报、环境描述和美术方向转化为可供评审的图像概念。
参考图引导的编辑
在保持工作流中原始资源不变的前提下,用自然语言指令对已批准的源图进行变换。
本地化视觉内容生产
根据地区、格式和渠道调整提示词细节,同时保持请求校验和资源跟踪的一致性。
端点、定价、模型身份、图像输入和平台关系。
Grok API 常见问题
Grok Imagine Image 2.0 API 端点是什么?
对于图像生成,向 https://api.x.ai/v1/images/generations 发送带 Bearer 认证的 POST 请求。对于图像编辑,使用 https://api.x.ai/v1/images/edits。
我应该使用哪个模型名称?
当前的 Grok Imagine Image 2.0 生成和编辑请求请使用 grok-imagine-image-2.0。
Grok API 的图像费用是多少?
xAI 目前列出的 Imagine Image 2.0 输出价格为每张生成图像 $0.04 至 $0.08,具体取决于分辨率和质量。图像输入列为每张 $0.01。部署前请确认当前定价。
我可以在一次请求中生成多张图像吗?
可以。xAI 文档说明输出数量可配置,单次生成请求最多可生成 10 张图像。
API 是否支持图生图工作流?
支持。图像编辑端点接受公共图像 URL 或 base64 data URI。多图编辑最多支持三张源图。
Grok 图像 API 是否兼容 OpenAI?
将基础 URL 设置为 https://api.x.ai/v1 并提供 xAI API 密钥,即可使用 OpenAI 客户端调用生成 API。
此页面是否由 xAI 运营或与 xAI 有官方关联?
不是。这是一份独立的开发者指南。Grok、Imagine 和 xAI 等名称仅用于标识模型和提供商;本页面不声称存在合作关系、获得官方认可,或由官方运营 API。
“imagine image 2.0 xAI API” 指的是什么?
它指的是通过 xAI 的图像生成和编辑端点暴露的 grok-imagine-image-2.0 模型。



