Gemini 图片生成指南

本文说明如何通过 FriModel 调用 Gemini 图片模型。示例已使用 gemini-3.1-flash-image-preview 实际验证。

1. 基础信息

API 地址：https://api.pinniq.org

请求方法：POST

接口路径：/v1beta/models/{model}:generateContent

鉴权请求头：x-goog-api-key: YOUR_API_KEY

Content-Type：application/json

推荐先使用：

gemini-3.1-flash-image-preview

可用模型可能随平台配置变化，建议先调用 GET /v1beta/models 查询当前列表。

2. 最小请求

3. 请求参数

路径参数

参数	必填	说明
`model`	是	Gemini 图片模型名称

请求头

参数	必填	说明
`Content-Type`	是	固定为 `application/json`
`x-goog-api-key`	是	FriModel API Key

请求体

参数	必填	说明
`contents`	是	输入内容列表
`contents[].role`	建议	通常填写 `user`
`contents[].parts[].text`	是	图片提示词
`generationConfig.responseModalities`	是	必须包含 `IMAGE`；需要文字说明时同时加入 `TEXT`
`generationConfig.imageConfig.aspectRatio`	否	如 `1:1`、`16:9`、`9:16`
`generationConfig.imageConfig.imageSize`	否	如 `1K`、`2K`

图片参数位于 generationConfig.imageConfig，不是 responseFormat.image。

4. 响应读取

生成内容位于：

candidates[0].content.parts[]

图片 part 的结构：

{
  "inlineData": {
    "mimeType": "image/png",
    "data": "BASE64_IMAGE_DATA"
  }
}

inlineData.data：Base64 图片内容

inlineData.mimeType：实际图片格式

文本说明可能出现在其他 part 的 text 字段

实际测试结果：

HTTP 状态码：200

本次复测返回 MIME：image/png；实际格式以 inlineData.mimeType 为准

请求：1:1、1K

实际图片：1024x1024

保存文件时应根据 mimeType 选择扩展名，不要固定写成 PNG。

5. Python 示例

6. 常见问题

没有返回图片

确认 responseModalities 中包含 IMAGE，并检查所有 parts[]，不要只读取第一个 part。

401 或 403

检查 x-goog-api-key 是否填写正确，以及 Key 是否有对应模型权限。

404

检查 URL 是否为：

/v1beta/models/{model}:generateContent

并通过 GET /v1beta/models 确认模型名称。

429 或 5xx

通常表示限流、上游繁忙或临时服务异常。建议按 2 秒、5 秒、10 秒进行有限次数的退避重试。

Base64 很大

这是正常现象。生产环境建议解码后上传到对象存储，只在业务响应中返回文件 URL，不要长期保存完整 Base64 字符串。

Gemini 图片生成指南（精简版-备份）

Gemini 图片生成指南#

1. 基础信息#

2. 最小请求#

3. 请求参数#

路径参数#

请求头#

请求体#

4. 响应读取#

5. Python 示例#

6. 常见问题#

没有返回图片#

401 或 403#

404#

429 或 5xx#

Base64 很大#