跳转到主要内容
POST
真实计费(默认 1K):使用 gemini-3.1-flash-lite-image 生成图片

同步生成 1K 图片

代表性成功响应如下。usageMetadata 用于观测,不代替图片是否存在的判断:

解析并保存图片

不要假设 parts[0] 一定是图片,也不要把扩展名固定成 PNG:

异步生成与图片编辑

异步调用使用 /v1/images/tasks,设置 model、action=generate、prompt、size=1K、aspect_ratio 和 n=1。同时设置 Idempotency-Key,保存 HTTP 202 返回的 task_id,再按轮询指南查询最终结果。 异步编辑改用统一 JSON,可以提供 1~16 张 Base64 来源图:

在线测试

本页表单固定调用 gemini-3.1-flash-lite-image:generateContent,并把尺寸限制为 1K。填入开发凭证前,先确认模型 ID 含 -image。
“试一试”会真实计费。Mintlify 会在生成的 cURL 中显示已输入的 Key,请勿分享带凭证的截图。
需要 2K 或 4K 时,转到Flash Image 参数页。

授权

Authorization
string
header
必填

YingTu API Key。

请求体

application/json
contents
消息 · object[]
必填

提示词和可选来源图。

Minimum array length: 1
generationConfig
输出设置 · object

响应

完整 Gemini 响应

candidates
object[]
必填
promptFeedback
object
usageMetadata
object
modelVersion
string

生成该响应的模型版本。

示例:

"gemini-3.1-flash-lite-image"

responseId
string

服务商响应标识。

示例:

"response_example"

createTime
string<date-time>

所选模型返回时的创建时间。

最后修改于 2026年9月3日