Troubleshooting

On this page, you will find some common questions or issues you might encounter when integrating the Photoroom API, along with their answer.

---

Q: Why do I get the error "Unauthorized" when calling the API?

A: If your call is resulting in this error:

{"error":{"message":"Unauthorized"}}

Then it's likely that you either forgot to put your apiKey in the headers of your call or that your credit balance has reached zero.

You can learn how to get your apiKey here and how to monitor your credit balance here.

---

Q: Can I send my image in Base64 format?

A: Yes, sending your image in Base64 format is possible for the Remove Background API.

Here's are some sample codes in JavaScript and Python:

JavaScript

const removeBackground = async (base64Image) => {
  const options = {
    method: "POST",
    headers: {
      "x-api-key": YOUR_API_KEY,
      "Content-Type": "application/json",
      Accept: "application/json",
    },
    body: JSON.stringify({
      image_file_b64: base64Image.split(",")[1],
    }),
  };

  fetch("https://sdk.photoroom.com/v1/segment", options)
    .then((response) => response.json())
    .then((response) => {
      console.log(response);
    })
    .catch((err) => console.error(err));
};

Python

import requests
import json
import base64

def encode_image_to_base64(image_path):
    """Reads an image file and converts it to a base64-encoded string."""
    with open(image_path, "rb") as image_file:
        return base64.b64encode(image_file.read()).decode("utf-8")

def remove_background(base64_image, api_key):
    url = "https://sdk.photoroom.com/v1/segment"
    
    headers = {
        "x-api-key": api_key,
        "Content-Type": "application/json",
        "Accept": "application/json",
    }

    data = {
        "image_file_b64": base64_image
    }

    try:
        response = requests.post(url, headers=headers, data=json.dumps(data))
        response_data = response.json()
        print(response_data)
    except requests.exceptions.RequestException as err:
        print(f"Error: {err}")

# Usage
api_key = "YOUR_API_KEY"
base64_image = encode_image_to_base64("/path/to/your/image.jpg")
remove_background(base64_image, api_key)

---

Q: When I call the Remove Background API, the result image gets rotated

A: An image can be rotated through a value set inside the EXIF metadata of the image.

Because the Remove Background API doesn’t carry over EXIF metadata into the result image, the rotation will then get lost in the process.

The best solution to this problem is to physically perform the rotation by rotating the image itself before making the API call.

Here’s an example of how to do it when using the JavaScript library sharp:

async function removeImageBackground (imageBuffer) {
    // Normalize the image orientation based on its EXIF Orientation tag
    // Then reset the EXIF Orientation tag to 1
    const normalizedImageBuffer = await sharp (imageBuffer)
        .rotate() // Automatically adjust rotation based on EXIF data
        .withMetadata({ orientation: 1 }) // Reset EXIF Orientation tag to 1
        .toBuffer(); // Convert back to buffer for further processing

    console. log ('Image orientation normalized to EXIF rotation value 1.');

    // Make the API call
}

This problem should not happen when using the Image Editing API.

---

Q: I'm using Axios to make the API call, but I can't decode the result image

A: Calls to the Photoroom API will return a binary image in the body of the HTTP response.

In order to properly decode the image when using Axios to make the API call, you'll need to configure the call with the option { responseType: 'arraybuffer' } :

const url = /* create the URL for your API call */

const options = { responseType: 'arraybuffer' }

const result = await axios.get(url, options)

---

Q: I'm using requests in Python and I get a 500 error

A: If you're using the requests library in Python to make your API call and you're getting a 500 error, please make sure that you are not manually setting the HTTP header Content-Type: multipart/form-data.

This header is already being automatically added by the requests library, so adding it a second time in your code will lead to a malformed request.

import os
import requests

def process_image(input_image_path, output_image_path):
    try:
        url = "https://sdk.photoroom.com/v1/segment"

        with open(input_image_path, 'rb') as image_file:
            files = { "image_file": image_file }

            headers = {
                "Accept": "image/png, application/json",
                "x-api-key": API_KEY,
                'Content-Type': 'multipart/form-data', # 👈 this line need to be removed
            }

            response = requests.post(url, files=files, headers=headers)
            response.raise_for_status()

            with open(output_image_path, 'wb') as f:
                f.write(response.content)
                print(f"Image downloaded and saved to {output_image_path}")

Q: Photoroom API has stopped working/answering

A: The Photoroom API is used by the Photoroom iOS, Android, and Web apps. Timeouts are unlikely to happen or would impact our own products in a critical way.

If Photoroom API has stopped working on your side, please check the following points:

1. Do you still have credits? Visit your dashboard and check your remaining credits, you can buy more credits directly from your dashboard if needed.

2. Is the API returning an error or an erroneous image? Report your technical bug or issue using the procedure explained in the following question.

---

Q: I have a technical issue/bug with Photoroom API

A: We currently don't provide technical support for implementing the API over email.

In case of an integration issue or of a bug on Photoroom's side:

1. Join our online community

2. Share with us:

   • A standalone code to reproduce the bug

   • The original input image you used

   • The output image returned by Photoroom API

   • A detailed description or visual example of the expected image you would have liked to get

We will investigate the issue and come back to you shortly.