原生Gemini格式图像生成

POST

/v1beta/models/{model}:generateContent

Gemini原生（图像）

使用 Google Gemini 原生格式调用 AboAI API

简介

Gemini 原生 API 采用 Google Gemini 的请求与响应格式，适用于 Google 官方客户端（如 google-generativeai SDK）或需要直接使用 Gemini 数据结构的场景。该接口遵循 Gemini API 规范，支持思考模式（Thinking）、多模态输入、工具调用、Google 搜索（Grounding）、图像生成等完整能力。

API 端点

功能	方法	路径
内容生成（非流式）	POST	`/v1beta/models/{model}:generateContent`

认证

支持以下任一方式：

Header 参数	类型	说明
`Authorization`	string	Bearer Token：`Bearer sk-xxxxxxxxxx`（推荐，与 AboAI 其他接口一致）
`x-goog-api-key`	string	Google 风格 API Key：`x-goog-api-key: sk-xxxxxxxxxx`

也可在 URL 中传参：?key=sk-xxxxxxxxxx。

请求参数

Authorization

在 header 添加参数

x-goog-api-key

示例：

x-goog-api-key: ********************

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "生成一张可爱的卡通猫咪图片"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "imageSize": "1k",
            "aspectRatio": "16:9"
        },
        "maxOutputTokens": 4096
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.peakkai.ai/v1beta/models/gemini-2.5-flash-image:generateContent?key=undefined' \
--header 'Authorization;' \
--header 'x-goog-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "生成一张可爱的卡通猫咪图片"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "imageSize": "1k",
            "aspectRatio": "16:9"
        },
        "maxOutputTokens": 4096
    }
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "回复文本\n"
          },
          {
            "inlineData": {
              "data": "",
              "mimeType": "image/png"
            }
          }
        ],
        "role": "model"
      },
      "index": 0,
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": integer,
    "candidatesTokenCount": integer,
    "totalTokenCount": integer,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": integer
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "IMAGE",
        "tokenCount": integer
      },
      {
        "modality": "TEXT",
        "tokenCount": integer
      }
    ]
  },
  "modelVersion": "gemini-2.5-flash-image",
  "responseId": "sXvYaYm-IqjZ8eEP6fv1oAI"
}

修改于 2026-11-02 08:23:18

原生OpenAI格式图像生成

原生OpenAI格式图像编辑（JSON）

原生Gemini格式 图像生成

Gemini原生 （图像）#

简介#

API 端点#

认证#