用于生成与编辑的 Grok Image API

通过独立的 GoEnhance API 使用 Grok Image。既可以从文本提示词生成,也可以提供最多九张参考图做图生图编辑,然后通过轮询或 HTTPS 回调获取异步结果。GoEnhance 不是 xAI,本接口也不是 xAI 官方 API。
创建 API Key
未来感创意实验室中的抽象光影艺术作品,象征 Grok Image API

一个端点同时支持新图生成与参考图编辑

电影感武士场景,象征由提示词驱动的 Grok Image 生成
时尚大片风格人像,象征参考图引导的图像编辑
只使用文档中列出的请求字段,并在提交前完成校验。

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. 创建 API Key
1

1. 创建 API Key

创建 GoEnhance Key,并在服务端的 Authorization 请求头中传入。
2. 构造请求
2

2. 构造请求

model: grok-image 发起 POST 请求并附带提示词。做参考图编辑时加上 image_list,做文本生成图像时选择支持的比例。
3. 跟踪任务并读取结果
3

3. 跟踪任务并读取结果

从成功响应中读取 data.img_uuid,并与你自己的任务记录关联。然后轮询 GET /api/v1/jobs/detail,或提供公网可访问的 HTTPS custom_callback_url,把处理中、成功和失败当作明确的状态分别处理。
把图像生成与编辑接入已经在管理提示词、审核和分发的产品。

Grok Image 的开发者应用场景

编辑类插图

根据文章选题简报生成原创场景概念图,并送入审核队列。

营销创意变体

以提示词驱动,产出支持的竖版、方形或横版比例的视觉方向。

参考图引导的风格改写

使用已获授权的源图生成可控的视觉变体,供后续审核。

产品概念图

把结构化的产品描述和可选参考图转化为视觉探索素材。

角色与场景构思

根据描述性提示词生成角色、道具和场景的草稿概念。

自动化创意流水线

把异步任务串联到回调、内容审核、存储、审批和下游处理环节。
关于价格、输入、比例与接入的常见问题解答。

Grok Image API 常见问题

用 Grok Image API 开始构建

Grok Image API:价格与接入指南 | GoEnhance