imagen-3.0

This documentation is valid for the following list of our models:

• imagen-3.0-generate-002

Model Overview

Google's latest text-to-image AI model, designed to generate high-quality, photorealistic images from text descriptions with improved detail, lighting, and fewer artifacts. It boasts enhanced natural language understanding and better text rendering.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

Submit a request

API Schema

post

/v1/images/generations

Authorizations

Body

promptstring · max: 400required

The text prompt for the image

convert_base64_to_urlboolean · default: false

If the condition is true, the url to the image will be returned; otherwise, the file will be provided in base64 format.

num_imagesinteger · max: 4 · default: 1

The number of images to generate

seedinteger · max: 4294967295

The random seed for image generation

enhance_promptboolean · default: true

An optional parameter to use an LLM-based prompt rewriting feature to deliver higher quality images that better reflect the original prompt's intent. Disabling this feature may impact image quality and prompt adherence

add_watermarkboolean · default: false

Add an invisible watermark to the generated images

modelundefined · enumrequired

Options: imagen-3.0-generate-002

aspect_ratiostring · enum · default: 1:1

The aspect ratio for the image

Options: 1:1, 9:16, 16:9, 3:4, 4:3

person_generationstring · enum · default: allow_adult

Allow generation of people by the model

Options: dont_allow, allow_adult

safety_settingstring · enum · default: block_medium_and_above

Adds a filter level to safety filtering

Options: block_low_and_above, block_medium_and_above, block_only_high

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/v1/images/generations' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "text",
    "convert_base64_to_url": false,
    "num_images": 1,
    "seed": 1,
    "enhance_prompt": true,
    "add_watermark": false,
    "model": "imagen-3.0-generate-002",
    "aspect_ratio": "1:1",
    "person_generation": "allow_adult",
    "safety_setting": "block_medium_and_above"
  }'

201

201

No body