Merchant API code sample to remove product image background. ### Java // Copyright 2025 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package shopping.merchant.samples.productstudio.v1alpha; import com.google.api.gax.core.FixedCredentialsProvider; import com.google.auth.oauth2.GoogleCredentials; import com.google.shopping.merchant.productstudio.v1alpha.ImageServiceClient; import com.google.shopping.merchant.productstudio.v1alpha.ImageServiceSettings; import com.google.shopping.merchant.productstudio.v1alpha.InputImage; import com.google.shopping.merchant.productstudio.v1alpha.OutputImageConfig; import com.google.shopping.merchant.productstudio.v1alpha.RemoveImageBackgroundConfig; import com.google.shopping.merchant.productstudio.v1alpha.RemoveProductImageBackgroundRequest; import com.google.shopping.merchant.productstudio.v1alpha.RemoveProductImageBackgroundResponse; import com.google.shopping.merchant.productstudio.v1alpha.RgbColor; import shopping.merchant.samples.utils.Authenticator; import shopping.merchant.samples.utils.Config; /** This class demonstrates how to create product images with the background removed. */ public class RemoveProductImageBackgroundSample { private static String getName(String accountId) { return String.format("accounts/%s", accountId); } public static void removeProductImageBackground(Config config, String imageUri) throws Exception { // Obtains OAuth token based on the user's configuration. GoogleCredentials credential = new Authenticator().authenticate(); ImageServiceSettings imageServiceSettings = ImageServiceSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(credential)) .build(); String name = getName(config.getAccountId().toString()); // Calls the API and catches and prints any network failures/errors. try (ImageServiceClient imageServiceClient = ImageServiceClient.create(imageServiceSettings)) { OutputImageConfig outputImageConfig = // Set this field to false to return the image bytes in the response instead. OutputImageConfig.newBuilder().setReturnImageUri(true).build(); InputImage inputImage = InputImage.newBuilder() // You can also use image bytes here instead of a URI. .setImageUri(imageUri) .build(); RemoveImageBackgroundConfig removeImageBackgroundConfig = RemoveImageBackgroundConfig.newBuilder() // Setting the background color to green. Don't set this field if you want the image // to have a RGBA 4-channel transparent image as the background. .setBackgroundColor(RgbColor.newBuilder().setRed(0).setGreen(255).setBlue(0)) .build(); RemoveProductImageBackgroundRequest request = RemoveProductImageBackgroundRequest.newBuilder() .setName(name) .setOutputConfig(outputImageConfig) .setInputImage(inputImage) .setConfig(removeImageBackgroundConfig) .build(); System.out.println("Sending RemoveProductImageBackground request: " + name); RemoveProductImageBackgroundResponse response = imageServiceClient.removeProductImageBackground(request); System.out.println("Removed product image background response below:"); System.out.println(response); } catch (Exception e) { System.out.println("An error has occurred: "); System.out.println(e); } } public static void main(String[] args) throws Exception { Config config = Config.load(); // Replace with your image URI. String imageUri = "https://services.google.com/fh/files/misc/abundance_intention_bath_salts.jpg"; removeProductImageBackground(config, imageUri); } } ### Python # -*- coding: utf-8 -*- # Copyright 2025 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """This class demonstrates how to create product images with the background removed.""" from examples.authentication import configuration from examples.authentication import generate_user_credentials from google.shopping.merchant_productstudio_v1alpha import ImageServiceClient from google.shopping.merchant_productstudio_v1alpha import InputImage from google.shopping.merchant_productstudio_v1alpha import OutputImageConfig from google.shopping.merchant_productstudio_v1alpha import RemoveImageBackgroundConfig from google.shopping.merchant_productstudio_v1alpha import RemoveProductImageBackgroundRequest from google.shopping.merchant_productstudio_v1alpha import RgbColor # Gets the merchant account ID from the user's configuration. _ACCOUNT = configuration.Configuration().read_merchant_info() # The name of the account to which the request is sent. # Format: accounts/{account} _NAME = f"accounts/{_ACCOUNT}" def remove_product_image_background(image_uri: str) -> None: """Removes the background from a product image. Args: image_uri: The URI of the input image. """ # Gets OAuth Credentials. credentials = generate_user_credentials.main() # Creates a client. client = ImageServiceClient(credentials=credentials) # Creates the output config. # Set `return_image_uri` to False to return the image bytes in the response. output_config = OutputImageConfig(return_image_uri=True) # Creates the input image. # You can also use image bytes here instead of a URI. input_image = InputImage(image_uri=image_uri) # Creates the remove image background config. # Setting the background color to green. Don't set this field if you want the # image to have a RGBA 4-channel transparent image as the background. remove_image_background_config = RemoveImageBackgroundConfig( background_color=RgbColor(red=0, green=255, blue=0) ) # Creates the request. request = RemoveProductImageBackgroundRequest( name=_NAME, output_config=output_config, input_image=input_image, config=remove_image_background_config, ) # Makes the request and catches and prints any error messages. try: print(f"Sending RemoveProductImageBackground request: {_NAME}") response = client.remove_product_image_background(request=request) print("Removed product image background response below:") print(response) except RuntimeError as e: print("Request failed.") print(e) if __name__ == "__main__": # The URI of the image to remove the background from. # Replace with your image URI. _IMAGE_URI = ( "https://services.google.com/fh/files/misc/abundance_intention_bath_salts.jpg" ) remove_product_image_background(_IMAGE_URI)