Gemini 原生图片

适用于 Gemini 原生图片模型，使用 Gemini 请求体，不走 OpenAI 的 prompt / size / image 字段。

接口

POST /v1beta/models/{model}:generateContent

支持模型

gemini-3-pro-image-preview-同步
gemini-3.1-flash-image-preview-同步

请求头

http

Authorization: Bearer sk-xxxxxx
Content-Type: application/json

图片生成参数标注（适用部分 key）

Gemini 原生路由不使用 OpenAI 风格的 prompt / size / image 字段。客户端应直接传 Gemini 请求体。

字段	类型	必填	说明
`contents`	array	是	对话内容，含文本或图片输入
`contents[].parts[].text`	string	否	文本 prompt
`contents[].parts[].inlineData`	object	否	base64 图片输入
`contents[].parts[].fileData`	object	否	文件 URI 输入
`generationConfig.responseModalities`	array	否	如 `["IMAGE"]`
`generationConfig.imageConfig.aspectRatio`	string	否	如 `16:9`
`generationConfig.imageConfig.imageSize`	string	否	如 `2K`

以下 OpenAI 风格字段对 Gemini 原生路由不适用：

prompt
size
image
n
quality
response_format

示例

json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张科技风海报"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

cURL 示例

bash

curl --request POST \
  --url 'https://bigbangtoken.com/v1beta/models/gemini-3-pro-image-preview-同步:generateContent' \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "生成一张科技风海报" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

常见返回

返回结构以上游为准，平台尽量原样透传 Gemini 响应字段。

计费

按次计费

注意事项

当前不做内容校验
当前不做 contents 结构校验
当前不做图片数量、mimeType、URL 直链的前置检查

Gemini 原生图片 ​

接口 ​

支持模型 ​

请求头 ​

图片生成参数标注（适用部分 key） ​

示例 ​

cURL 示例 ​

常见返回 ​

计费 ​

注意事项 ​

相关文档 ​