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

参数

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

会返回什么

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

然后轮询取图

这个 Playground 只覆盖创建调用。拿上面响应里的 id 去读任务, 直到 status 变成 completedfailed——一张 1K 图大约 15–40 秒。
完成的任务带一个 outputs 数组,里面是图片 URL:
产物 URL 不鉴权,并且在任务创建 24 小时后失效。下载时要带 User-Agent—— 分发 CDN 对不带这个头的请求直接返回 403

下一步

概览

这个系列的全部参数、分辨率档位与实测时延。

异步任务 API

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