Generate Image With Gemini Native API

POST

/v1beta/models/{model}:generateContent

使用 Gemini 原生 generateContent 接口生成图片。
详细信息参考：https://ai.google.dev/gemini-api/docs/image-generation。
请求和响应结构尽量保持 Google AI Studio API 风格，平台仅在鉴权、代理路由和可选的图片 URL 改写上做增强。

与按次付费版的区别

本接口走 Gemini 原生 contents / parts

使用原生模型名，例如 gemini-2.5-flash-image

可通过 image_response_format 在 base64 和 url 之间切换返回形式

不走 POST /v1/images/generations 的公开模型名封装

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Query Params

Header Params

Body Params application/jsonRequired

Examples

文生图，默认 Base64 返回文生图，URL 返回多图融合

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Generate a square icon of a blue paper airplane on a white background."
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "imageSize": "2K",
            "aspectRatio": "1:1"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图，默认 Base64 返回文生图，URL 返回多图融合

curl --location --request POST 'https://api.ccapi.ai//v1beta/models/:generateContent?key=sk-xxxx' \
--header 'x-goog-api-key: sk-xxxx' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Generate a square icon of a blue paper airplane on a white background."
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "imageSize": "2K",
            "aspectRatio": "1:1"
        }
    }
}'

Responses

🟢200成功

application/json

成功

Body

Examples

默认 Base64 返回URL 返回

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "image/png",
                            "data": "iVBORw0KGgoAAAANSUhEUgAA..."
                        }
                    },
                    {
                        "text": "Here is a generated image based on your prompt."
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 42,
        "candidatesTokenCount": 2520,
        "totalTokenCount": 2562
    }
}

🟠400请求有误

🟠401未认证

🟠403权限不足

Modified at 2026-03-14 17:18:15

Create Text Completion (Legacy)

Generate Image

Generate Image With Gemini Native API

与按次付费版的区别#

Request

Request Code Samples

Responses

与按次付费版的区别