同步生成图像

正式环境

https://api.naoshengyun.com

POST

/v1beta/models/{model}:generateContent

使用 Gemini 原生 generateContent 协议同步生成或编辑图像。通过 generationConfig.imageConfig.imageSize 选择 1K、2K 或 4K 输出。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

1K 生图2K 生图4K 生图图片编辑

使用 Gemini 原生协议生成 1K 图片。

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张雨夜霓虹灯下的橘猫插画，电影感，细节丰富"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

1K 生图2K 生图4K 生图图片编辑

curl --location 'https://api.naoshengyun.com/v1beta/models/gemini-3.1-flash-image:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张雨夜霓虹灯下的橘猫插画，电影感，细节丰富"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [
        {"text": "已生成图片。"},
        {"inlineData": {"mimeType": "image/png", "data": "iVBORw0KGgoAAAANSUhEUgAA..."}}
      ]
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {"promptTokenCount": 24, "candidatesTokenCount": 258, "totalTokenCount": 282},
  "modelVersion": "gemini-3.1-flash-image"
}

修改于 2026-09-24 01:30:28

查询异步生图任务