跳转到主要内容
POST
同步生成图片(真实计费)
调用方能够保持连接直到完整 Gemini 响应返回时,使用本接口。 通用 schema 会显示整个家族的尺寸和宽高比并集,发送前必须再看所选模型的参数页:2.5 不能传 imageSize,Lite 只能使用 1K,只有 Flash 支持 1:4、4:1、1:8、8:1。
“试一试”会从浏览器直接发送真实请求并可能产生费用。请使用开发密钥,确认模型与尺寸, 不要分享包含密钥的生成 cURL 或鉴权截图。

先选模型

根据生命周期、尺寸和相对成本选择。

理解同步方式

设置连接超时并正确读取所有 parts。

根据状态码处理失败

分清参数、密钥、余额、限流和服务端错误。

授权

Authorization
string
header
必填

YingTu API Key。

路径参数

model
enum<string>
必填

Current public image model ID.

可用选项:
gemini-2.5-flash-image,
gemini-3.1-flash-lite-image,
gemini-3.1-flash-image,
gemini-3-pro-image,
gpt-image-2-web,
gpt-image-2-vip

请求体

application/json
contents
提示词与输入 · object[]
必填

发送给模型的消息。

Minimum array length: 1
tools
object[]

可选 Gemini 工具;是否可用取决于所选图片模型。

toolConfig
object

在 tools 中声明的工具配置。

safetySettings
object[]
systemInstruction
object
cachedContent
string

所选模型支持时使用的可选缓存内容资源名称。

generationConfig
输出设置 · object

响应

完整 Gemini 响应

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

生成该响应的模型版本。

示例:

"gemini-3.1-flash-image"

responseId
string

服务商响应标识。

示例:

"response_example"

createTime
string<date-time>

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

最后修改于 2026年9月2日