生成图像（Nano Banana）

POST

https://ai-api.kkidc.com/v1beta/models/{model}:generateContent

谷歌Gemini API 请求
路径格式: /v1beta/models/{model_name}:{action}

流式请求：/v1beta/models/{model}:streamGenerateContent?alt=sse（优先使用）

非流式请求：/v1beta/models/{model}:generateContent

图片生成较慢，超时时间建议设置600秒

使用代码程序调用，不要直接apifox调试（apifox有限制超时会主动断开）

可选模型ID例如：

gemini-2.5-flash-image（Nano Banana）

gemini-3.1-flash-image-preview（Nano Banana 2）

gemini-3-pro-image-preview（Nano Banana Pro）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

文生图图生图

{
    "contents": [
        {
            "parts": [
                {
                    "text": "a dragon flying over mountains"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图图生图

curl --location 'https://ai-api.kkidc.com/v1beta/models/gemini-2.5-flash-image:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "a dragon flying over mountains"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K"
        }
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA..."
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 20,
    "candidatesTokenCount": 50,
    "totalTokenCount": 70
  }
}

🟠429限流

🟠400请求有误

修改于 2026-06-17 08:37:08

文本对话（优先）

文本对话