跳转到主要内容
POST
图片生成

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
string
必填

必填。使用 Get Models 返回的模型 ID 或可用别名。

Minimum string length: 1
示例:

"gemini-3.1-flash-image"

"gemini-3-pro-image"

"gemini-2.5-flash-image"

prompt
string
必填

必填。生成图片的提示词。

Required string length: 1 - 32000
images
(string | object)[]

可选。图生图参考图,最多 14 张;具体数量上限以所选模型为准。省略时为文生图。

Required array length: 1 - 14 elements
Minimum string length: 1
size
enum<string>

输出宽高比。网关把该字段约分并映射为 Gemini aspectRatio;它不是像素尺寸。极端比例 1:4、4:1、1:8、8:1 仅 gemini-3.1-flash-image 支持。

可用选项:
1:1,
1:4,
1:8,
2:3,
3:2,
3:4,
4:1,
4:3,
4:5,
5:4,
8:1,
9:16,
16:9,
21:9
quality
enum<string>

输出分辨率映射:low→512px、standard→1K、medium→2K、high/hd→4K、auto/省略→不指定。gemini-2.5-flash-image 只支持 1K。

可用选项:
standard,
hd,
low,
medium,
high,
auto

Gemini 原生扩展,是否启用 Google Search grounding;仅支持此能力的模型可用。

Gemini 原生扩展,是否启用图片搜索 grounding;仅支持此能力的模型可用。

thinking_level
enum<string>

Gemini 原生扩展,模型思考强度;仅支持此能力的模型可用。

可用选项:
Minimal,
High
response_format
enum<string>
默认值:url

Tikway 图片交付格式,url 返回图片链接,b64_json 返回纯 Base64。默认 url;该字段由网关消费,不作为上游模型参数。

可用选项:
b64_json,
url

响应

200 - application/json
created
integer
必填

图像创建时的 Unix 时间戳(秒)。

data
object[]
必填

生成结果列表。

background
enum<string>

实际采用的背景设置。

可用选项:
transparent,
opaque
output_format
enum<string>

实际输出图像格式。

可用选项:
png,
webp,
jpeg
quality
enum<string>

实际生成质量。

可用选项:
low,
medium,
high
size
string

实际生成的图像尺寸。

usage
object

GPT Image 模型的 token 用量。