Single image generation with gemini-3-pro-image-preview, controlling aspect ratio and clarity.

Developing

POST

/v1/chat/completions

Official documentation: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing

Request

Header Params

Body Params application/json

Example

{
    "model": "gemini-3-pro-image-preview",
    "stream": false,
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "text": "Generate an image of a toy placed on a dining table, with an aspect ratio of 16:9 and a resolution of 2K.",
                    "type": "text"
                },
                {
                    "image_url": {
                        "url": "https://gips3.baidu.com/it/u=1022347589,1106887837&fm=3028&app=3028&f=JPEG&fmt=auto?w=960&h=1280"
                    },
                    "type": "image_url"
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/chat/completions' \
--header 'Authorization: {{Authorization}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-3-pro-image-preview",
    "stream": false,
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "text": "Generate an image of a toy placed on a dining table, with an aspect ratio of 16:9 and a resolution of 2K.",
                    "type": "text"
                },
                {
                    "image_url": {
                        "url": "https://gips3.baidu.com/it/u=1022347589,1106887837&fm=3028&app=3028&f=JPEG&fmt=auto?w=960&h=1280"
                    },
                    "type": "image_url"
                }
            ]
        }
    ]
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{}

Modified at 2026-10-19 10:10:04

Image understanding

Multi-image fusion slice generation with gemini-3-pro-image-preview, controlling aspect ratio and clarity.