Docs

Google Imagen

POST

/v1/images/generations

Google’s highest quality image generation model

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

model

string

optional

Put imagen4, imagen4-fast, imagen4-ultra or imagen-3.0-generate-002

prompt

string

required

The text description of the desired image. Maximum length is 1000 characters.

response_format

string

optional

The format of the returned generated image. Must be one of url or b64_json.

aspect_ratio

string

optional

Input: 1:1 , 16:9, 9:16, 3:4 or 4:3
Image ratios and resolutions
1:1: 1024x1024
3:4: 896x1280
4:3: 1280x896
9:16: 768x1408
16:9: 1408x768

Example

{
  "model": "imagen4",
  "prompt": "A person walking in the forest",
  "aspect_ratio": "1:1",
  "response_format": "url"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "imagen4",
  "prompt": "A person walking in the forest",
  "aspect_ratio": "1:1",
  "response_format": "url"
}'

Responses

🟢200Create image

application/json

Body

data

array [object {1}]

required

url

string

required

created

integer

required

Example

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}

Modified at 2025-06-27 09:12:47

Generative Upscale

Bytedance - seedream-3.0