跳转到主要内容
POST
真实计费(省略 imageSize):使用 gemini-2.5-flash-image 生成图片

同步生成

这个模型必须省略 imageSize。以下请求允许模型同时返回说明文字和图片:
代表性响应中,图片可能不是第一个 part:

提交并轮询异步任务

把统一任务请求发送到 /v1/images/tasks。提交时设置 Idempotency-Key;收到 HTTP 202 后保存 task_id,再查询 /v1/tasks/{task_id},直到进入 completed、failed 或 expired。完整的超时、退避和 Retry-After 处理见轮询指南。
该模型继续省略 size。完成后从 image.data 解码图片,并按网关根据真实字节修正后的 image.mimeType 选择扩展名。

使用参考图编辑

在文字内容后加入 inlineData。mimeType 必须与来源字节一致,data 只放 Base64 内容,不放 data URL 前缀。

在线测试

本页嵌入的表单固定调用 gemini-2.5-flash-image:generateContent。先检查请求中没有 imageSize,再填入开发凭证发送同步请求。
在线测试会真实计费。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-2.5-flash-image"

responseId
string

服务商响应标识。

示例:

"response_example"

createTime
string<date-time>

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

最后修改于 2026年9月3日