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

同步生成 2K 图片

代表性响应为 JPEG,但调用方必须继续读取实际 MIME:

用 Python 提交异步任务

以下示例使用超宽 4:1 比例。生产代码还应处理 429 的 Retry-After、网络抖动与随机退避,完整实现见轮询指南。
完成后从 image.data 解码图片,并使用网关按真实字节修正后的 image.mimeType 选择文件扩展名。

编辑来源图片

编辑响应可能先给文字内容,再给图片内容。遍历全部 candidates[].content.parts[],按 inlineData.mimeType 决定扩展名。

在线测试

本页表单固定调用 gemini-3.1-flash-image:generateContent。先用 1K 验证提示词,再按真实交付需要选择 2K 或 4K。
尺寸会影响真实计费。Mintlify 会在生成的 cURL 中显示已输入的 Key,请勿分享带凭证的截图。
全部比例与尺寸规则见参数页。

授权

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-image"

responseId
string

服务商响应标识。

示例:

"response_example"

createTime
string<date-time>

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

最后修改于 2026年9月3日