POST
https://api.yuannengai.com
/
v1beta
/
models
/
gemini-2.5-flash-image-preview:generateContent
curl --request POST \
  --url 'https://api.yuannengai.com/v1beta/models/gemini-2.5-flash-image-preview:generateContent' \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <YOUR_API_KEY>' \
  --data '{
    "contents": [
      {
        "parts": [
          {
            "text": "生成一张日出时分的海边灯塔图片"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE", "TEXT"]
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA..."
            }
          },
          {
            "text": "这是一张日出时分海边灯塔的图片，展现了温暖的晨光和宁静的海面。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 45,
    "totalTokenCount": 57
  }
}
  • 即时响应模式，直接返回 base64 编码的图像数据
  • 使用标准 Gemini API 格式请求
  • 快速高效的图像生成，适合需要快速响应的场景
curl --request POST \
  --url 'https://api.yuannengai.com/v1beta/models/gemini-2.5-flash-image-preview:generateContent' \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <YOUR_API_KEY>' \
  --data '{
    "contents": [
      {
        "parts": [
          {
            "text": "生成一张日出时分的海边灯塔图片"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE", "TEXT"]
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA..."
            }
          },
          {
            "text": "这是一张日出时分海边灯塔的图片，展现了温暖的晨光和宁静的海面。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 45,
    "totalTokenCount": 57
  }
}

​
认证方式

​
x-goog-api-key
string
必填
使用 Gemini 原生格式时，需要通过 x-goog-api-key 请求头传递 API Key获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
x-goog-api-key: YOUR_API_KEY

​
请求参数

​
contents
array
必填
对话内容数组
​
generationConfig
object
生成配置

​
响应参数

​
candidates
array
生成结果数组
​
usageMetadata
object
Token 使用统计

​
使用示例

​
快速生成图像

import requests
import base64

def quick_generate(prompt, api_key):
    """快速生成图像"""
    url = "https://api.yuannengai.com/v1beta/models/gemini-2.5-flash-image-preview:generateContent"

    payload = {
        "contents": [{"parts": [{"text": prompt}]}],
        "generationConfig": {"responseModalities": ["IMAGE", "TEXT"]}
    }

    response = requests.post(
        url,
        json=payload,
        headers={
            "Content-Type": "application/json",
            "x-goog-api-key": api_key
        }
    )

    result = response.json()

    for part in result["candidates"][0]["content"]["parts"]:
        if "inlineData" in part:
            return base64.b64decode(part["inlineData"]["data"])

    return None

# 使用示例
image_bytes = quick_generate("一只橘猫", "your-api-key")
if image_bytes:
    with open("cat.png", "wb") as f:
        f.write(image_bytes)

​
批量生成图像

import requests
import base64
import asyncio
import aiohttp

async def generate_image_async(session, prompt, api_key):
    """异步生成单张图像"""
    url = "https://api.yuannengai.com/v1beta/models/gemini-2.5-flash-image-preview:generateContent"

    payload = {
        "contents": [{"parts": [{"text": prompt}]}],
        "generationConfig": {"responseModalities": ["IMAGE"]}
    }

    async with session.post(
        url,
        json=payload,
        headers={"x-goog-api-key": api_key}
    ) as response:
        result = await response.json()

        for part in result["candidates"][0]["content"]["parts"]:
            if "inlineData" in part:
                return part["inlineData"]["data"]

    return None

async def batch_generate(prompts, api_key):
    """批量生成图像"""
    async with aiohttp.ClientSession() as session:
        tasks = [generate_image_async(session, p, api_key) for p in prompts]
        results = await asyncio.gather(*tasks)
        return results

# 使用示例
prompts = ["一只猫", "一只狗", "一只兔子"]
# images = asyncio.run(batch_generate(prompts, "your-api-key"))

​
与 Gemini-3-Pro 的区别

特性Gemini-2.5-FlashGemini-3-Pro
响应速度更快 ⚡标准
图像质量良好更高 ✨
适用场景快速原型、批量生成高质量输出、精细创作
成本更低 💰标准
选择建议： - 需要快速生成或批量处理时，选择 Gemini-2.5-Flash - 需要高质量图像输出时，选择 Gemini-3-Pro

​
注意事项

重要提示： - 返回的图像数据是 base64 编码的，需要解码后才能保存或显示 - responseModalities 必须包含 "IMAGE" 才能生成图像 - 生成的图像默认为 PNG 格式 - Flash 模型响应更快，但图像质量可能略低于 Pro 模型