<a href="https://console.cloud.google.com/vertex-ai/studio/media/generate;tab=image"target="console" track-name="consoleLink" track-type="task">Go to MediaStudio</a>

1. ClickImagen. The Imagen Media Studio image generation page is displayed.

2. Optional: In theSettings pane, configure the following settings:

   • Model: Choose a model from the available options.

     For more information about available models, seeImagenmodels

   • Aspect ratio: Choose an aspect ratio from the available options.

   • Number of results: Adjust the slider or enter a value between1 and4.

   • Output resolution: Choose a resolution from the available options.

3. Optional: In theAdvanced options section, select aRegion togenerate your images in.

4. In theWrite your prompt box, enter your text prompt that describesthe images to generate. For example,small boat on water in the morningwatercolor illustration.

   For more information about writing effective prompts, seePromptand image attributeguide.

5. ClicksendGenerate.

A digital watermark is automatically added to generated images. You can'tdisable digital watermark for image generation using the Google Cloud console.

You can select an image to view in theImage detail window.Watermarked images contain alocal_policeDigital watermark badge. Youcan also explicitlyverify an image watermark.

Python

Install

pip install --upgrade google-genai

To learn more, see the SDK reference documentation.

Set environment variables to use the Gen AI SDK with Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values# with appropriate values for your project.exportGOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECTexportGOOGLE_CLOUD_LOCATION=globalexportGOOGLE_GENAI_USE_VERTEXAI=True

fromgoogleimportgenaifromgoogle.genai.typesimportGenerateImagesConfigclient=genai.Client()# TODO(developer): Update and un-comment below line# output_file = "output-image.png"image=client.models.generate_images(model="imagen-4.0-generate-001",prompt="A dog reading a newspaper",config=GenerateImagesConfig(image_size="2K",),)image.generated_images[0].image.save(output_file)print(f"Created output image using{len(image.generated_images[0].image.image_bytes)} bytes")# Example response:# Created output image using 1234567 bytes

REST

Before using any of the request data, make the following replacements:

• REGION: The region that your project is located in. For more information about supported regions, seeGenerative AI on Vertex AI locations.
• PROJECT_ID: Your Google Cloudproject ID.

• MODEL_VERSION: The Imagen model version to use. For more information about available models, seeImagen models.

• TEXT_PROMPT: The text prompt that guides what images the model generates. This field is required for both generation and editing.
• IMAGE_COUNT: The number of images to generate. The accepted range of values is1 to4.

Additional optional parameters

Use the following optional variables depending on your use case. Add some or all of the following parameters in the"parameters": {} object. This list shows common optional parameters and isn't meant to be exhaustive. For more information about optional parameters, seeImagen API reference: Generate images.

"parameters": {  "sampleCount":IMAGE_COUNT,  "addWatermark":ADD_WATERMARK,  "aspectRatio": "ASPECT_RATIO",  "enhancePrompt":ENABLE_PROMPT_REWRITING,  "includeRaiReason":INCLUDE_RAI_REASON,  "includeSafetyAttributes":INCLUDE_SAFETY_ATTRIBUTES,  "outputOptions": {    "mimeType": "MIME_TYPE",    "compressionQuality":COMPRESSION_QUALITY  },  "personGeneration": "PERSON_SETTING",  "safetySetting": "SAFETY_SETTING",  "seed":SEED_NUMBER,  "storageUri": "OUTPUT_STORAGE_URI"}

• ADD_WATERMARK: boolean. Optional. Whether to enable a watermark for generated images. Any image generated when the field is set totrue contains a digitalSynthID that you can use to verify a watermarked image. If you omit this field, the default value oftrue is used; you must set the value tofalse to disable this feature. You can use theseed field to get deterministic output only when this field is set tofalse.
• ASPECT_RATIO: string. Optional. A generation mode parameter that controls aspect ratio. Supported ratio values and their intended use:
  • 1:1 (default, square)
  • 3:4 (Ads, social media)
  • 4:3 (TV, photography)
  • 16:9 (landscape)
  • 9:16 (portrait)
• ENABLE_PROMPT_REWRITING: boolean. Optional. A 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. Default value:true.
• INCLUDE_RAI_REASON: boolean. Optional. Whether to enable theResponsible AI filtered reason code in responses with blocked input or output. Default value:true.
• INCLUDE_SAFETY_ATTRIBUTES: boolean. Optional. Whether to enable rounded Responsible AI scores for a list of safety attributes in responses for unfiltered input and output. Safety attribute categories:"Death, Harm & Tragedy","Firearms & Weapons","Hate","Health","Illicit Drugs","Politics","Porn","Religion & Belief","Toxic","Violence","Vulgarity","War & Conflict". Default value:false.
• MIME_TYPE: string. Optional. The MIME type of the content of the image. Available values:
  • image/jpeg
  • image/gif
  • image/png
  • image/webp
  • image/bmp
  • image/tiff
  • image/vnd.microsoft.icon
• COMPRESSION_QUALITY: integer. Optional. Only applies to JPEG output files. The level of detail the model preserves for images generated in JPEG file format. Values:0 to100, where a higher number means more compression. Default:75.
• PERSON_SETTING: string. Optional. The safety setting that controls the type of people or face generation the model allows. Available values:
  • allow_adult (default): Allow generation of adults only, except for celebrity generation. Celebrity generation is not allowed for any setting.
  • dont_allow: Disable the inclusion of people or faces in generated images.
• SAFETY_SETTING: string. Optional. A setting that controls safety filter thresholds for generated images. Available values:
  • block_low_and_above: The highest safety threshold, resulting in the largest amount of generated images that are filtered. Previous value:block_most.
  • block_medium_and_above (default): A medium safety threshold that balances filtering for potentially harmful and safe content. Previous value:block_some.
  • block_only_high: A safety threshold that reduces the number of requests blocked due to safety filters. This setting might increase objectionable content generated by Imagen. Previous value:block_few.
• SEED_NUMBER: integer. Optional. Any non-negative integer you provide to make output images deterministic. Providing the same seed number always results in the same output images. If the model you're using supports digital watermarking, you must set"addWatermark": false to use this field. Accepted integer values:1 -2147483647.
• OUTPUT_STORAGE_URI: string. Optional. The Cloud Storage bucket to store the output images. If not provided, base64-encoded image bytes are returned in the response. Sample value:gs://image-bucket/output/.

HTTP method and URL:

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_VERSION:predict

Request JSON body:

{  "instances": [    {      "prompt": "TEXT_PROMPT"    }  ],  "parameters": {    "sampleCount":IMAGE_COUNT  }}

To send your request, choose one of these options:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_VERSION:predict"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_VERSION:predict" | Select-Object -Expand Content

{"predictions":[{"bytesBase64Encoded":"BASE64_IMG_BYTES","mimeType":"image/png"},{"mimeType":"image/png","bytesBase64Encoded":"BASE64_IMG_BYTES"}]}

If you use a model that supports prompt enhancement, the response includes anadditionalprompt field with the enhanced prompt used forgeneration:

{  "predictions": [    {      "mimeType": "MIME_TYPE",      "prompt": "ENHANCED_PROMPT_1",      "bytesBase64Encoded": "BASE64_IMG_BYTES_1"    },    {      "mimeType": "MIME_TYPE",      "prompt": "ENHANCED_PROMPT_2",      "bytesBase64Encoded": "BASE64_IMG_BYTES_2"    }  ]}