v1beta（官方格式-图片编辑）

正式环境

https://api.302.ai

POST

/v1/v1beta/models/{model}:generateContent

支持模型：
gemini-2.5-flash-image-preview
gemini-2.5-flash-image
gemini-3-pro-image-preview

Google原版格式：https://ai.google.dev/gemini-api/docs/image-generation
注意：作为preview模型，建议明确指出 “输出图片”，否则可能只有文本

我们302对这个接口做了2个优化：
1.
支持返回url或原始bs64 data
2.
支持传入image_url对图片进行编辑

价格：输入 0.3 PTC/1M Tokens 输出 30 PTC/1M Tokens

请求参数

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200OK

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

cURL

传url格式的图片传base64格式的图片

curl --location --request POST 'https://api.302.ai/v1/v1beta/models/gemini-2.5-flash-image-preview:generateContent?response_format' \
--header 'x-goog-api-key: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "parts": [
                {
                    "text": "变成Ghibli卡通风格"
                },
                {
                    "image_url": "https://file.302ai.cn/gpt/imgs/20250507/d778f9319c534b1c8ffc49c15db14fb1.jpg"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ]
    }
}'

响应示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Sure, here is your image! "
                    },
                    {
                        "url": "https://file.302.ai/gpt/imgs/20251210/b8262ed273b54800ad4e4f7b99952477.png"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP"
        }
    ],
    "createTime": "2025-12-10T10:30:53.890609Z",
    "modelVersion": "gemini-2.5-flash-image",
    "responseId": "3Us5afGtNoSn998PvLHjwAs",
    "usageMetadata": {
        "candidatesTokenCount": 1298,
        "candidatesTokensDetails": [
            {
                "modality": "IMAGE",
                "tokenCount": 1290
            },
            {
                "modality": "TEXT",
                "tokenCount": 8
            }
        ],
        "promptTokenCount": 33,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 33
            }
        ],
        "totalTokenCount": 1331,
        "trafficType": "ON_DEMAND"
    }
}

修改于 2026-01-21 06:59:56

v1beta（官方格式-文生图）

Chat（聊天）