Skip to main content
POST
Playground
填入你的 API Key 和提示词,然后发送。这里打的是线上接口,和你代码里调的是同一个。
从这个页面发出的请求是真实的,会计入你的 Key。 一张图按模型和档位不同约 $0.02 到 $0.08。这里没有沙箱,也没有 mock。

参数

string
必填
用哪个模型。接受 grok-imagine-imagegrok-imagine-image-2.0grok-imagine-image-quality,精确匹配,没有别名。
object
必填
生成参数。下面没列出的键一律以 invalid_params 拒绝。
string
任务结束后把结果 POST 到这个地址,省掉轮询。必须是 https, 其他形式在提交时就会被拒。

会返回什么

提交立刻返回,一秒都用不到。图片不在这个响应里——生成是在后台进行的。

然后轮询取结果

这个 Playground 只覆盖创建调用。拿上面响应里的 id 去读任务, 直到 status 变成 completedfailed——大约 7 到 10 秒。
完成的任务带一个 outputs 数组:
产物 URL 不鉴权,并且在任务完成 24 小时后失效。 usage.cost_in_usd_ticks原价,实际扣费是它乘以你所在分组的倍率—— 见计价

下一步

概览

全部参数、分辨率与质量的组合,以及实测时延。

异步任务 API

轮询闭环、回调,以及完整错误表。