API reference overview: To view an overview of the API options for image generation andediting, see theimagegeneration model API reference.

Learn how to use Imagen on Vertex AI's text-to-image generation feature andverify a digital watermark (SynthID) on a generated image. Thisquickstart shows you how to use Imagen image generation in theGoogle Cloud console.

Imagen on Vertex AI pricing is based on the feature you use. For moreinformation, seePricing.

Before you begin

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Vertex AI API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.
Enable the API
Make sure that you have the following role or roles on the project: Vertex AI User
Check for the roles
1. In the Google Cloud console, go to theIAM page.

   Go to IAM
2. Select the project.

3. In thePrincipal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check theRole column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to theIAM page.

   Go to IAM
2. Select the project.
3. Clickperson_addGrant access.

4. In theNew principals field, enter your user identifier. This is typically the email address for a Google Account.

5. In theSelect a role list, select a role.
6. To grant additional roles, clickaddAdd another role and add each additional role.
7. ClickSave.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.

Enable the API

Make sure that you have the following role or roles on the project: Vertex AI User

Check for the roles

1. In the Google Cloud console, go to theIAM page.

   Go to IAM
2. Select the project.

3. In thePrincipal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check theRole column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to theIAM page.

   Go to IAM
2. Select the project.
3. Clickperson_addGrant access.

4. In theNew principals field, enter your user identifier. This is typically the email address for a Google Account.

5. In theSelect a role list, select a role.
6. To grant additional roles, clickaddAdd another role and add each additional role.
7. ClickSave.

Generate images and save a local copy

Send the text-to-image generation request using the Google Cloud console.

1. In the Google Cloud console, go to theVertex AI> Media Studiopage.

   Go to Media Studio

2. In thePrompt (Write your prompt here) field, enter the followingprompt:

    portrait of a french bulldog at the beach, 85mm f/2.8

3. If not selected, in theModel options box in theParameters panel, selectImagen 3.

4. If not selected, in theAspect ratio section in theParameters panel, select1:1.

5. In theNumber of results section, change theNumber of results to2.

6. Clickplay_arrowGenerate.

   Generating images produces images similar to the following images:

   

7. To save a local copy of an image, click one of the images.

8. In theImage details window that opens, clickExport.

9. In theExport image dialog box, clickExport.

Verify an image's digital watermark

After you generate watermarked images, you can verify the digital watermark ofthe novel images.

1. Create generated images and save a local copy as you did in the previousstep.

2. In theImage detail window, clickExport.

3. In the lower panel, clicklocal_policeVerify.

4. ClickUpload image.

5. Select a locally-saved generated image.

   

Congratulations! You've just used the Imagen text-to-imagegeneration feature to create novel images and verify the digital watermark ofone of the images.

Clean up

To avoid incurring charges to your Google Cloud account for the resources usedon this page, follow these steps.

What's next

• Learn about all image generative AI features in theImagen on Vertex AI overview.
• Readusageguidelines forImagen on Vertex AI.
• Explore more pretrained models inModel Garden.
• Learn aboutresponsible AI best practices and Vertex AI's safetyfilters.