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

用 Python 生成 4K 图片

代表性 4K 响应如下。实际文件格式仍以 mimeType 为准:

提交异步任务

当客户端或代理无法保持长连接时,提交统一图片任务:
保存 HTTP 202 返回的 task_id,查询 /v1/tasks/{task_id}。completed 时遍历 result.candidates[].content.parts[] 查找 inlineData;failed 或 expired 时停止轮询并记录结构化错误。

编辑产品图

4K 响应的 Base64 很大。完成后尽快转存到自有对象存储,普通日志只保留 responseId、modelVersion、任务状态和自有文件地址。

在线测试

本页表单固定调用 gemini-3-pro-image:generateContent。建议保留预填的 1K 请求完成首次验证,确认确有高分辨率需求后再改为 4K。
Pro 请求会真实计费。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-pro-image"

responseId
string

服务商响应标识。

示例:

"response_example"

createTime
string<date-time>

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

最后修改于 2026年9月3日