用于生成与编辑的 Grok Image API
通过独立的 GoEnhance API 使用 Grok Image。既可以从文本提示词生成,也可以提供最多九张参考图做图生图编辑,然后通过轮询或 HTTPS 回调获取异步结果。GoEnhance 不是 xAI,本接口也不是 xAI 官方 API。
创建 API Key
一个端点同时支持新图生成与参考图编辑
文本生成图像
将 model 设为 grok-image,传入 1–2,000 个字符的提示词,并选择 2:3、3:2、1:1、9:16 或 16:9。该比例仅对纯文本请求生效。

参考图编辑
在 image_list 中加入 1 到 9 个可访问的图片 URL,即可运行图生图生成。存在参考图时,文档中的比例字段会被忽略。

只使用文档中列出的请求字段,并在提交前完成校验。
Grok Image API 能力
统一的图像端点
向 <code>https://api.goenhance.ai/api/v1/images/generations</code> 发送 JSON POST 请求。
精确指定模型
将必填的 <code>model</code> 值设为 <code>grok-image</code>。
提示词校验
必须提供文本提示词,长度在 1 到 2,000 个字符之间。
可选的参考图
图生图请求可在 <code>image_list</code> 中提供 1 到 9 个 URL 对象。
纯文本请求的宽高比
未提供参考图列表时,可选择 2:3、3:2、1:1、9:16 或 16:9。
异步结果处理
保存 <code>img_uuid</code>,然后轮询任务详情或处理 HTTPS 回调事件。
当前 GoEnhance 文档对每张生成图片给出固定费率。
Grok Image API 价格
每张图 1.3 点数
文档记载每次成功的 Grok Image 生成消耗 1.3 个 GoEnhance 点数。
每张图 $0.026
文档记载的美元等价价格为每张生成图片 $0.026。
处理余额相关响应
除 HTTP 状态码外,还要检查 JSON 响应中的 code;点数不足可能返回 <code>code: 100</code>。
四步接入 Grok Image API
1
1. 创建 API Key
创建 GoEnhance Key,并在服务端的
Authorization 请求头中传入。 2
2. 构造请求
以
model: grok-image 发起 POST 请求并附带提示词。做参考图编辑时加上 image_list,做文本生成图像时选择支持的比例。 3
3. 跟踪任务并读取结果
从成功响应中读取
data.img_uuid,并与你自己的任务记录关联。然后轮询 GET /api/v1/jobs/detail,或提供公网可访问的 HTTPS custom_callback_url,把处理中、成功和失败当作明确的状态分别处理。把图像生成与编辑接入已经在管理提示词、审核和分发的产品。
Grok Image 的开发者应用场景
编辑类插图
根据文章选题简报生成原创场景概念图,并送入审核队列。
营销创意变体
以提示词驱动,产出支持的竖版、方形或横版比例的视觉方向。
参考图引导的风格改写
使用已获授权的源图生成可控的视觉变体,供后续审核。
产品概念图
把结构化的产品描述和可选参考图转化为视觉探索素材。
角色与场景构思
根据描述性提示词生成角色、道具和场景的草稿概念。
自动化创意流水线
把异步任务串联到回调、内容审核、存储、审批和下游处理环节。
关于价格、输入、比例与接入的常见问题解答。
