同步生成图片

正式环境

https://api.naoshengyun.com

POST

/v1beta/models/{model}:generateContent

同步返回 Gemini 原生响应。model 必须是当前 API Key 所在渠道可用的
Gemini 图片模型；组织 API Key 会按模型自动选择对应的 Gemini 分组。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

文生图图片编辑

{
    "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

文生图图片编辑

curl --location 'https://api.naoshengyun.com/v1beta/models/: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": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADElEQVR42mNk+M/wHwAF/gL+7WwNAAAAAElFTkSuQmCC"
                        }
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 24,
        "candidatesTokenCount": 258,
        "totalTokenCount": 282,
        "candidatesTokensDetails": [
            {
                "modality": "IMAGE",
                "tokenCount": 256
            }
        ]
    },
    "modelVersion": "gemini-3.1-flash-image"
}

🟠400InvalidArgument

🟠401Unauthenticated

🟠403PermissionDenied

🟠429ResourceExhausted

🔴502UpstreamFailure

修改于 2026-08-17 03:10:21

查询异步生图任务

同步生成图像