This product or feature is a Generative AI Preview offering, subject to the "Pre-GA Offerings Terms" of theGoogle Cloud Service Specific Terms, as well as the Additional Terms for Generative AI Preview Products. For this Generative AI Preview offering, Customers may elect to use it for production or commercial purposes, or disclose Generated Output to third-parties, and may process personal data as outlined in theCloud Data Processing Addendum, subject to the obligations and restrictions described in the agreement under which you access Google Cloud. Pre-GA products are available "as is" and might have limited support. For more information, see thelaunch stage descriptions.

Imagen product recontext on Vertex AI lets you edit product images into different scenes orbackgrounds. You provide images of a product and an optional prompt, andImagen product recontext generates images of your product inrecontextualized in new scenes or backgrounds.

To request access to Imagen product recontext, complete theVertex AI -Generative Media for Marketing AccessRequestform.

Supported product types

Imagen product recontext supports the following product types:

• Appliances
• Business and industrial
• Clothing
• Electronics
• Furniture
• Garden and yard
• Hardware
• Health and beauty
• Jewelry
• Pets
• Shoes
• Sporting goods
• Toys and games
• Vehicles

Product recontextualization example

The following shows an example use case for product recontextualization:

Sample Inputs	Sample Outputs	Prompt used
		On a cluttered workbench in a rainy, neon-lit cyberpunk alley, with holographic advertisements flickering in the background.
		Placed on a mossy rock on the edge of a cliff, overlooking a massive, powerful waterfall in a dramatic, overcast Icelandic landscape.
		Resting on a white cafe table in Santorini, with a cup of coffee, overlooking the Aegean Sea and iconic blue-domed buildings.

Try Imagen product recontext in a Colab

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

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

1. Set up authentication for your environment.

   To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

   Install the Google Cloud CLI. After installation,initialize the Google Cloud CLI by running the following command:

   gcloudinit

   If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

   For more information, seeAuthenticate for using REST in the Google Cloud authentication documentation.

Generate product images in different scenes

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/imagen-product-recontext-preview-06-30:predict

{  "instances": [    {      "prompt": "TEXT_PROMPT",      "productImages": [        {          "image": {            "bytesBase64Encoded": "BASE64_SUBJECT_IMAGE"          },        }      ]    }  ],  "parameters": {    "personGeneration":PERSON_SETTING,    "safetySetting":SAFETY_SETTING,    "addWatermark":WATERMARK_SETTING,    "sampleCount":IMAGE_COUNT,    "enhancePrompt":PROMPT_SETTING  }}

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/imagen-product-recontext-preview-06-30: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/imagen-product-recontext-preview-06-30:predict" | Select-Object -Expand Content

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