grok-imagine-image-2.0 构建文生图和图像编辑工作流。xAI API 通过兼容 OpenAI 的图像端点支持可配置的画面比例、分辨率、输出数量和响应格式。用于 Imagine Image 2.0 的 Grok API
使用
创建 xAI API 密钥
选择合适的 Grok 图像工作流
发送生产环境请求前，先验证媒体输入和输出设置。
Grok Imagine Image 2.0 API 功能
专用图像模型
将 <code>model</code> 设置为 <code>grok-imagine-image-2.0</code>，用于当前的 Imagine Image 2.0 生成和编辑。
文生图生成
向 <code>/v1/images/generations</code> 发送提示词，并一次请求最多生成 10 张图像。
可配置输出
选择画面比例、1K 或 2K 分辨率、输出数量以及受支持的响应格式。
图像编辑
向 <code>/v1/images/edits</code> 发送编辑指令，并附上公开图像 URL 或 base64 编码的数据 URI。
最多三个编辑参考图
多图编辑最多接受三张源图像，用于构图、主体组合和风格引导。
Bearer 认证
在 <code>Authorization</code> 请求头中发送 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 构建什么
营销活动创意变体
通过结构化提示词模板，为广告、落地页和社交媒体活动生成多种视觉方向。
产品与概念可视化
将产品简报、环境描述和美术方向转化为可供评审的图像概念。
参考图引导的编辑
在保持工作流中原始资源不变的前提下，用自然语言指令对已批准的源图进行变换。
本地化视觉内容生产
根据地区、格式和渠道调整提示词细节，同时保持请求校验和资源跟踪的一致性。
端点、定价、模型身份、图像输入和平台关系。