生成图像（Nano Banana）

POST

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

谷歌Gemini API 请求
路径格式: /v1beta/models/{model_name}:{action}
可选模型ID例如：

gemini-2.5-flash-image

gemini-3.1-flash-image-preview

gemini-3-pro-image-preview

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "parts": [
                {
                    "text": "a dragon flying over mountains"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

示例

{
  "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-03-06 10:51:25

文本对话

生成图像