v1beta (Official Format - Image Editing)

POST

/v1beta/models/{model}:generateContent

From Google's gemini-2.5-flash-image model
Original Google format: https://ai.google.dev/gemini-api/docs/image-generation
Note: As a preview model, it is recommended to explicitly specify "output image", otherwise you may only get text

We at 302 have made 2 optimizations to this endpoint:
1.
Supports returning url or raw bs64 data
2.
Supports passing in image_url for image editing

Pricing: Input 0.3 PTC/1M Tokens Output 30 PTC/1M Tokens

Request

Path Params

Query Params

Header Params

Body Params application/json

Examples

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

{
    "contents": [
        {
            "parts": [
                {
                    "text": "变成Ghibli卡通风格"
                },
                {
                    "image_url": "https://file.302ai.cn/gpt/imgs/20250507/d778f9319c534b1c8ffc49c15db14fb1.jpg"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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: sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--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"
        ]
    }
}'

Responses

🟢200OK

application/json

Body

Example

{
    "completed_at": "",
    "created_at": "",
    "error": "",
    "id": "",
    "model": "",
    "output": "",
    "started_at": "",
    "status": ""
}

Modified at 2025-09-03 02:29:20

v1beta (Official Format - Text-to-Image)

Chat（Talk）