Gemini 图片 Generate Content

Gemini 图片模型接口，适合通过 Gemini 原生 generateContent 格式进行生图、改图或图像相关任务。

重要提示 (关于 New API / One API 兼容性)

New API / One API 平台不支持 /v1beta/models/... 原生协议接口。 如果你使用的是 New API / One API 等中转分发平台，请勿调用此原生格式接口（中转平台无法解析 Google Gemini 的原生 JSON 结构及路由，会引发请求报错）。

迁移建议： 对于中转平台用户，若需生成图像，推荐使用更通用的 OpenAI 兼容文生图接口：Images Generations (/v1/images/generations)，并在 model 中填入相关的生图模型名称。

接口信息

项目	值
方法	POST
路径	/v1beta/models/gemini-2.5-flash-image:generateContent
完整地址	https://api.gemai.cc/v1beta/models/gemini-2.5-flash-image:generateContent
鉴权	Authorization: Bearer sk-你的令牌

请求体示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "生成一张 16:9 的猫咪咖啡馆宣传图。" }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"]
  }
}

代码示例

cURL

curl --location 'https://api.gemai.cc/v1beta/models/gemini-2.5-flash-image:generateContent' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "生成一张 16:9 的猫咪咖啡馆宣传图。" }]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }'

JavaScript

const response = await fetch('https://api.gemai.cc/v1beta/models/gemini-2.5-flash-image:generateContent', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    contents: [
      {
        role: 'user',
        parts: [{ text: '生成一张 16:9 的猫咪咖啡馆宣传图。' }],
      },
    ],
    generationConfig: {
      responseModalities: ['TEXT', 'IMAGE'],
    },
  }),
})

console.log(await response.json())

Python

import os
import requests

response = requests.post(
    'https://api.gemai.cc/v1beta/models/gemini-2.5-flash-image:generateContent',
    headers={
        'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'contents': [
            {'role': 'user', 'parts': [{'text': '生成一张 16:9 的猫咪咖啡馆宣传图。'}]},
        ],
        'generationConfig': {
            'responseModalities': ['TEXT', 'IMAGE'],
        },
    },
    timeout=300,
)

response.raise_for_status()
print(response.json())

返回示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          { "text": "已生成图片。" },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "base64..."
            }
          }
        ]
      }
    }
  ]
}

注意事项

• 生图或改图时请确认模型支持图片输出。
• 返回图片可能是 Base64，需要自行保存为文件。